Frequently Asked Questions

It is possible to reset your Client Secret if you forget it.

To do this click on ‘Apps’ in the main menu, click on the app in question, navigate to the ‘Client Secret’ section and select ‘Reset’.

A plan is a collection of API resources or subsets of resources from one or more API. A plan can contain a mixture of HTTP, GET, PUT, POST and DELETE actions from different APIs or it can contain all the actions from various APIs. A plan can have a common rate limit for all the resources or each resource can have a different rate limit. Rate limits specify how many calls an app is allowed to make during a specified time interval.

Use the Developer Portal to browse the different plans that are available and select a plan that is more suitable for your requirements. Some plans are restricted and require you to request access before you can use them. When you submit your request, the organisation is notified, the API administrator assesses your request and they might contact you for more details. Other plans are available to use straight away.

When you add an app you are provided with a client ID and client secret for the app. You must supply the client ID when you call an API that requires you to identify your app by using a client ID, or a client ID and client secret.

To register an app click on Apps in the main menu and then click on the 'Register an application' link. Once you have provided an app name, description, etc you will be shown your app client ID and client secret.

Make a note of your client secret because it is only displayed once. You must supply the client secret when you call an API that requires you to identify your app by using a Client ID and Client secret.

The numbers of requests, for different APIs, that your application has made are shown on your application page.

Click 'Apps' in the main menu and then click on your application. Under 'Subscribed Plans' you will see all plans your application is subscribed to. 

For each API contained in that plan you can see the usage compared to the rate limit of the plan.

It is possible to test an API from the Developer Portal.

When looking at the details of an API, you will see a table of the operations contained in the API. This will show what method they use (GET, POST, PUT, DELETE, PATCH, HEAD or OPTIONS) and what path the resource uses.

If you select the resource, you will see more information about it: which parameters it may take, what it returns, what possible return codes it may use and what they mean.

There is also a ‘Try’ button which enables you to try the resource out directly from the Developer Portal.

If the API requires a Client ID or a Client Secret for identification, you can specify these at the top of the ‘Try’ section.