Connecting to an API

Subscribing to an API

If the API has pricing associated with it, you will need to select a pricing plan before calling the API. Prices are based on a recurring monthly subscription based on the plan selected — plus overage fees applied if you exceed a plan’s quota limits.

A lot of APIs have a BASIC free plan, which means you can use that plan to test the API for free as long as you stay within the quota limits. It’s your responsibility to review and acknowledge the plan’s usage limitations.

🚧

Staying in your API plan's quota limit

It is extremely important to know how close you are to the quota limit for your subscription. You will be charged for any additional usage that goes over the limit. You can see your usage and remaining quota amount from the Developer Dashboard or by using the response headers

Requesting approval to use an API's plan

If a Request Approval workflow has been enabled for an API, API consumers will see a Subscribe to Test button when viewing the APIs endpoints.

1746

Also, from the Pricing tab for an API, the user selects a team or personal context, then clicks Request Access.

2198

When this is selected, the question configured by the API builder will be displayed for the developer requesting access to fill in.

2002

While the API consumer is waiting for approval to use the API, the Pricing tab for the requested context will contain "Pending Approval".

936

An API consumer can track their open requests by navigating to their Developer Dashboard (My Apps), then clicking the Approvals tab.

2760

When an API consumer has requested access to an API plan, the API provider is sent an email notification about the request.

📘

Approvals center

API consumers can also use the Approvals link in the header to navigate to the Approvals link in the Developer Dashboard. For more information, see Header Links and Icons.

Testing an API from your browser

Now that you have subscribed to an API plan, you will want to head back to the Endpoints tab. From here you can test the API endpoint directly in the browser by changing the input for the endpoint. Once you make a request to the API by using the Test Endpoint button, you will also see the response directly in the browser.

Integrating the API into an application

Once you find an API you want to integrating into an application, simply switch back to the Request Snippet tab. Now, select the programing language your app is using and copy the code snippet right into your app. We also provide an installation guide to help you get started with the request library provided. For more help integrating the API into your application, check out our SDK Guide.

1914

Fig 4. Copy code snippet