Consumer API - Overview¶
An API Consumer is typically an application developer who may be internal or external to your organization. Consuming APIs is the process by which the application developer accesses the various APIs that are exposed by you (the API provider) and then uses those APIs to develop one’s own software applications and products.
API consumers discover and access APIs from the Developer Portal of your MWARE ESB as shown below.
API Consumer Tasks¶
The process of consuming an API from MWARE ESB involves the following steps:
Discover APIs¶
When APIs are created and published through the Publisher, they become available through the Developer Portal. Developers can use the search option to find APIs of interest.
Subscribe to APIs¶
Before using an API, the developer must first subscribe to the APIs and obtain the required authentication keys through an application.
Applications
An application is a logical representation of a physical application such as a mobile app, webapp, device, etc. An API subscription is created, authenticated, and managed through an application. Find out more about applications.
Authentication
The subscription process is authenticated using OAuth2 by default. The authentication keys are generated for each application per gateway environment (Production or Sandbox). When the subscribing developer invokes the API through an application, the access token for the relevant gateway environment should be used.
Business Plans
Developers need to select a business plan for each API subscription. The business plan determines the number of requests that are allowed to be sent to the API per minute. Therefore, this is also the throttling policy that applies to a subscription.
Test APIs¶
Before using an API for development, the API consumer may want to test it’s capabilities. The following options are available in the Developer Portal for testing:
- Test APIs using the Integrated API Console
- Test GraphQL APIs Using the Integrated GraphQL Console
- Test an API Using a SOAP Client
- Test a REST API Using Postman
Rate and Support APIs¶
As members of the API consumer community, developers can rate and support the APIs through the Developer Portal. This is also a forum where API consumers can give feedback to the API providers.
Top