Is your current API set-up a bit unsightly? Are you struggling to get people to really engage with your APIs? Are third-party developers, partners and key stakeholders not able to easily consume the APIs they need?
If your response was a trio of yes’, there are time, money and resource savings to be made; enter our API Developer Portal.
Our custom-built solution combines an integrated API store with a developer portal that’s:
- With straightforward onboarding features and a suite of administration tools, the platform comes with everything you need to drive world-wide API adoption
- Developers are given a platform to rapidly integrate their apps with your APIs and test them in a safe, Sandbox environment
- Developers have the option to sign-up to customised, web-based portals
- Users can utilise their preferred enterprise APIs, collaborate with fellow developers, and contribute to the growth of your overall portal
- You can personalise the appearance of your platform to ensure a consistent brand experience for internal and external users
- Integrated Sandbox capability
- HTML document uploads
- Choose from static documents and OpenAPI
- Quick and easy access to statistics
- Real-time quota usage insights
- Online ticket system to report issues
- Personalised branding
- Customisable components
API Developer Portal?
B2B Partners vs. Internal Developers
- Easily invite and onboard external partners
- Share the platform with B2B users as a partner portal
- Support completely isolated internal and external APIs with individual visibility options
- Configure different usage plans for internal and external developers
Integration – key to Three Ireland’s successful API-driven transformation
Three Ireland decided to use its merger with Telefonica O2 as an opportunity to run a modernization initiative alongside the consolidation and rationalization of two different brands, over a 3-year period, driven by Torry Harris.
What is DigitMarketTM API Manager (DM-APIM)?
DigitMarketTM API Manager (DM-APIM) is a complete package to help manage your APIs and make them into tools that propel your business forward.
Our API Management product, “DigitMarketTM API Manager” has four components that work in unison to provide the following basic runtime functionality:
The Publisher Portal
The API publishers configure the APIs, API packs, usage plans, usage policies and so on using this portal. Key features:
- Create secure API proxies.
- Create API packs from multiple APIs.
- Advanced Policy library with facility to share policies across multiple APIs.
- Workflow/approval cycles on policy lifecycle.
- Configure transformations at API and resource levels.
- Ability to create multiple usage plans with different set of runtime policies for each plan Ex: Basic, Gold, Silver, Platinum, etc.
- Ability to selectively deploy and manage plans on different gateway runtime instances from a single screen.
- Near-real-time statistics visualisation.
- Advanced and highly granular role-based access control for all features - API Visibility, management, publishing and consuming.
The Developer Portal
The developers discover, explore, try out and subscribe to the publishers’ APIs using this portal. The publisher can tailor the appearance of the developer portal as per their needs. Key features:
- Developer self-registration.
- Ability to search and navigate the portal with the same user experience of an online store; with clear listing of most popular APIs, What's new, API price, description, etc.
- Facility to manage the subscriptions through an easy interface.
- Ability for internal and external developers, API providers to quickly view statistics of their API usage.
- Facility for API providers to easily expose/create APIs by proxying existing endpoints and attaching policy templates.
- Help / support ticket system built-in for API developers to report issues, bugs, etc.
The gateway enforces the policies defined by the publishers, validates the subscriptions, collects metrics, and enforces quotas. The gateway is configured and managed using the publisher portal. No coding or customisation is required. Key features:
- Event-driven paradigm used to implement the gateway, hence high concurrencies can be achieved easily.
- Policy enforcement (details of each policy is described in our answer to the next question).
- Cluster-wide policy enforcement.
- Quota overrun alerts with configurable threshold.
- Transaction recording for analytics.
- Multi-gateway runtime architecture to support isolation of high-traffic, high-volume APIs. Configuration and management is central though.
- Subscription validation and auto-renewal facility.
OAuth Authentication Server
- Token management.
- Supports OAuth custom grant types.
What are the basic functionalities offered by the Developer Portal to different segments of API consumers?
The developer portal component supports features that can be tailored for all types of consumers - Internal developers, B2B Partners, External developers like apptrepreneurs and general public. The publisher can tailor the appearance of the developer portal if the default appearance is not apt, since the developer portal HTML files are configurable.
- Features applicable for Open API Economy model (External developers like Apptrepreneurs and general public).
- AppStore-like interface for easy discovery and subscription to APIs.
- Explicit pricing information for public consumers with ability to hide pricing if required.
- Automatic subscription renewal feature, if enabled for specific developers.
- Workflow driven public developer verification to protect publishers from malicious developers.
- Features applicable for B2B Partners.
- Ability for API Publishers to on-board and provide access to partners on their behalf.
- Can share the developer portal to B2B users as partner portal.
- Features for internal developers.
- Each API supports visibility option, so developer portal can support mix of internal and external APIs that are fully isolated from each other.
- Ability for publishers to configure different usage plans/policies for the same API, one for internal and other for external developers.
- Common features that is applicable for all types of consumers.
- Integrated sandbox capability that allows publishers to easily create a playground for APIs. Developers can try out the API.
- Integrated API documentation using hybrid approaches - static documentation and OpenAPI (Swagger) test client. Documentation can be uploaded in the form of HTML, therefore the appearance can be tailored as per publisher wish.
- Statistics for API usage.
- Quota usage in real-time.
How customisable and configurable is the Developer Portal?
- DigitMarketTM API developer portal is fully customisable. All the capabilities of the developer portal are available as APIs and a revamped developer portal can be published via the CMS feature in the publisher portal. The users can choose to rebrand the developer portal or change flows on the developer portal using this capability. The default developer portal template is provided as part of product that can be used as a reference to customise the new set of navigation flows.
- Documentation can also be uploaded in customised templates while defining an API.
- API Categorisation and organising is built into the developer portal; and is administered via the publisher portal.
- Integrated Discussion forum that allows developers to ask questions, raise bugs, suggest features, etc.
- Integrated Sandbox environment and “Try It” for quick exploration.
- Ability to generate client code for different technologies based on the Swagger (OpenAPI) specification.
Do you offer a multi-tenant architecture for the Developer and Publisher portals?
Yes, we offer an innovative multi-tenant architecture for publisher and developer portal. Large, geographically distributed enterprises have different business units that would like to provide APIs to their community of consumers. DigitMarketTM API Manager supports multi-tenancy where one installation of the product supports a feature where in different API provider sub-organisations and consumer sub-organisations can be created. Each provider sub-organisation has its own exclusive publisher portal and associated developer portal for its consumers. The APIs, look and feel of the portal, etc can be customised by each tenant independent of other tenants.
When customers want isolated environments for themselves, we provide the same. Certain customers will be hesitant to share the application instance with others. In such cases we provide a separate managed instance on the cloud, at a separate cost.
How are APIs published onto the Developer Portal?
DigitMarketTM API Manager Developer and Publisher Portal are driven by workflows. Every new artifact, policy or a configuration change in the publisher portal goes through an approval cycle for governing and moderating the changes. Once the artifacts such as API proxies, packs, policies are configured on the publisher portal, it is submitted to the business user for approval. Once the configuration is approved, and synced with the gateway, publisher portal automatically publishes the APIs to the developer portal. The price plans, usage plans are explicitly shown to make the subscription process easier. Alternatively, publishers can choose to have hidden/private plans exclusively for B2B developers.
Do the portals support private B2B APIs?
Private B2B APIs between trading partners are common and must be managed. These APIs could be a part of a supply chain in manufacturing, in commerce between suppliers and retailers, or in healthcare or life sciences ecosystems.
API publishers can hide specific APIs and/or specific API features from the general public on the Developer Portal. Each API usage plan has visibility settings that allow granular configuration of APIs. For some B2B scenarios, we configure two-way SSL with mutual authentication where both the parties are known to each other. We configure additional security policies such as IP white-listing as both the provider and consumer endpoints are known to each other. Some of our clients prefer to deploy an instance of API gateway in a separate VPN-enabled network over the Internet, which is not visible to the general public. Some other clients prefer to combine partner-specific APIs with the Open API developer portal.
We also provide an extensible adapter SDK that allows creation of custom adapter for any B2B specific applications/protocols. Though the adapter for specific B2B protocol does not exist now, such as EDI, RosettaNet, etc, one time activity of adapter development as part of a project will help us re-use it across other instances where there is a need for those protocols.
How is Documentation Created and Reviewed in the API User Portal?
If the API is configured to use the documentation, the viewer is available inside the Developer Portal. Documentation is automatically uploaded from when the page is loaded. The API Manager who configures the documentation must have the right user account. However, anyone can have access to the documentation.
Digital Enablement Platform
digital capability for Pure Planet