API Developer Portal

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:

  • Easy-to-use
  • Secure
  • Reliable
Source: Ovum’s "On the Radar" Report, October 08, 2019
Analyst: Hansa Iyengar
 
 
 
How it Works?
  • 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

Key Features

  • 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
Why DigitMarketTM
API Developer Portal?
We’ve put Developer Experience at the centre of everything we do, and we’re pioneering and simplifying the way users navigate through marketplaces
Easy adoption guaranteed
We’ve modelled our journey around the AppStore and Playstore’s UX to deliver a smooth, familiar, and intuitive experience.
Personalisation when you need it
Filled with custom templates for defining APIs and flexibility around categorisation and organisation, our design caters to a custom set-up.
Personal experiences like no other
Incorporating design thinking and a user-centric interface, our screen-flows reflect the day-to-day activities of individual stakeholders, proactively anticipate next steps, and make required elements easy to access.
Unrivalled usability
With built-in features to help balance and manage one-time and repeated tasks, our portal comes with lots of subtle extras to eliminate developer frustration.
Everything you need in one place
We took a holistic approach when creating our product and included everything from mood boards, iterative prototyping and user feedback to storyboards, contextual analysis and persona-based design.
DigitMarketTM API Developer Portal for the Open API Economy
Transparency
Users can find key information around API prices, popular APIs, descriptions, and subscriptions - with the option to hide pricing as needed.
Self-sufficient elements
Developers can self-subscribe, and you can enable automatic renewals.
Open communication
With an integrated discussion forum, developers can ask questions, suggest new features, raise bugs, and more.
A safety-first approach
We protect the public from potentially malicious developers with a workflow-driven verification system.

B2B Partners vs. Internal Developers

We know every business and user will have their own wants and needs from their portal, which is why our features cater to each.
 
B2B partners
  • Easily invite and onboard external partners
  • Share the platform with B2B users as a partner portal
Internal developers
  • Support completely isolated internal and external APIs with individual visibility options
  • Configure different usage plans for internal and external developers

The Complete Package

By combining our market-leading DigitMarketTM API Developer Portal with our API Gateway and Publisher Portal, you’ll arm your business with a complete API management solution that:

  • Accelerates and revolutionises your digital transformation program
  • Benchmarks success for the rest of your industry
DigitMarketTM - create your digital ecosystems FASTER
DigitMarketTM is an API-driven framework of products, processes and services built to accelerate your digital strategy and fast-track implementation.
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.

FAQs

What is DigitMarketTM API Manager (DM-APIM)?

Our API Management product, DigitMarketTM API Manager (DM-APIM) is a complete package to help manage your APIs and turn them into tools that propel your business forward. It has four components that work in unison to provide the following basic runtime functionality:

The API Publisher Portal

This portal allows API publishers to configure the APIs, API packs, usage plans, usage policies, etc. Key features include:

  • Create secure API proxies
  • Create API packs from multiple APIs
  • Advanced Policy library with the 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 a different set of runtime policies for each plan. For instance, 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 visualization
  • Advanced and highly granular role-based access control for all features - API visibility, management, publishing, and consuming

The API Developer Portal

The Developer Portal helps developers discover, explore, try out and subscribe to the publishers’ APIs. The publisher can tailor the appearance of the developer portal as per their needs. Key features include:

  • Developer self-registration
  • Ability to search and navigate the API developer portal with the same user experience of an online store; with a clear listing of most popular APIs, What's new, API price, description, etc.
  • Facility to manage the subscriptions through an easy-to-use interface
  • The ability for internal and external developers and 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 API Gateway

The API 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 customization is required. Key features include:

  • The event-driven paradigm used to implement the gateway, easily achieving high concurrencies
  • 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

The OAuth authorization server is a software system that implements network protocol flows that allow a client software application to act on behalf of a user. Key features include:

  • Token management
  • Supports OAuth custom grant types

What are the basic functionalities offered by the Developer Portal to different segments of API consumers?

The API management developer portal supports features that can be tailored for all types of consumers - Internal developers, B2B Partners, External developers like apptrepreneurs, and the general public. The publisher can tailor the appearance of the developer portal if the default appearance is not appropriate since the developer portal HTML files are configurable.

  • Features applicable for Open API Economy model (External developers like Apptrepreneurs and the general public)
    • AppStore-like interface for easy discovery and subscription to APIs
    • Explicit pricing information for public consumers with the 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
    • The ability for API Publishers to onboard and provide access to partners on their behalf
    • Can share the developer portal to B2B users as a partner portal
  • Features for internal developers
    • Each API supports a visibility option, so the API developer portal can support a mix of internal and external APIs that are fully isolated from each other
    • The ability for publishers to configure different usage plans/policies for the same API, one for internal and the other for external developers
  • Common features that are applicable for all types of consumers
    • Integrated sandbox capability that allows publishers to easily create a playground for APIs, allowing developers to 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 the publisher’s wish
    • Statistics for API usage
    • Quota usage in real-time

How customizable and configurable is the Developer Portal?

DigitMarketTM API developer portal is fully customizable. 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 portal using this capability. The default developer portal template is provided as part of the product that can be used as a reference to customize the new set of navigation flows.

  • Documentation can also be uploaded in customized templates while defining an API
  • API categorization and organization is built into the developer portal, and is administered via the publisher portal
  • An 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 portals. 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 wherein different API provider sub-organizations and consumer sub-organizations can be created.

Each provider sub-organization has its own exclusive publisher portal and associated developer portal for its consumers. The APIs, look and feel of the portal, etc can be customized by each tenant independent of other tenants.

We also provide isolated environments for customers who are hesitant to share the application instance with others. In such cases, we provide a separately 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 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, the publisher portal automatically publishes the APIs to the developer portal. The price plans and 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 the 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. Others prefer to combine partner-specific APIs with the Open API developer portal.

We also provide an extensible adapter SDK that allows the creation of a custom adapter for any B2B-specific applications/protocols. Though the adapter for specific B2B protocol does not exist now, such as EDI, RosettaNet, etc, the 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 API Developer Portal. Documentation is automatically uploaded when the page is loaded. The API Manager that configures the documentation must have the right user account. However, anyone can have access to the documentation.

Up Next:Torry Harris enables API driven
digital capability for Pure Planet
 
Torry Harris helps Schneider Electric to integrate over 21 ERPs across 40 countries
Jean-Christophe Pharose, Global Finance Program Manager at Schneider Electric, talks about the “Concur” program, why it is useful and how Torry Harris played a crucial role in its success.
Up Next:Torry Harris builds Airtel’s
Digital Enablement Platform
 
Torry Harris enables API driven digital capability for Pure Planet
Andrew Ralston, Co-Founder and Chief Executive of Pure Planet, Britain’s first app-based renewable energy supplier, talks about Torry Harris being a trusted advisor in helping them build a meaningful digital ecosystem.
Up Next:Torry Harris helps Schneider Electric
to integrate over 21 ERPs across 40 countries
 
Torry Harris builds Airtel’s Digital Enablement Platform
Campbell McClean, Chief Information Officer at Airtel - Telemedia, TV and B2B, talks about his long-term association, trust and consistent success with Torry Harris.

What's New

Feature Stories...