API Store Guides
- Quick Start
- How do I access the API Store?
- How do I subscribe to an API?
- How do I manage my API subscriptions?
- How do I get the user key for an application?
- How do I regenerate the user key for my application?
- How do I use the user key?
- How do I test a REST API before I subscribe to it?
Quick Start
Step |
Description |
Reference |
---|---|---|
1 |
Browse through the API store to determine which APIs you want use for your applications. |
|
2 |
Create an account in the API store by signing up. |
|
3 |
Select an API and signup to its plan. |
|
4 |
Test the API. |
|
5 |
Call the API in your application. |
How do I access the API Store?
To use an API in the API Store, you must have an account.
- In the API Store main page, click Register/Login.
- Click Register. The Register to the API Store page opens.
3. Enter your credentials and click Register. A confirmation email will be sent to you by the administrator.
4. Click the link in the email. Click the link on the page to verify. The User login page opens in your browser.
5. Enter your credentials and click Log in.
How do I subscribe to an API?
Before you can use an API, you must subscribe to an API plan. The plan determines the number of API calls that your application can make. Some plans require approval. Think about what you need and choose the most suitable plan. Once your application is subscribed to a plan, the application is assigned a unique User Key (i.e. the user_key parameter). You must use this User Key when you call an API.
- Login to the API Store.
- Select the API listing link from the Menu drop down at the top of the page.
- Select the API you want to use for your application. The API details page opens.
- Click the Plans tab, then click the Subscribe to this plan button for the plan you have chosen. The Subscribe to API page opens.
- In the Nickname and Description boxes, enter your application's information (see above).
- Click Subscribe. The Subscription Summary page opens.
- Make a note of the User Key so you can use it in your API calls.
You can use the subscription after your Administrator sends you an email indicating your application has been approved.
How do I manage my API subscriptions?
- Login to the API Store.
- Select the Subscriptions link at the top right of the page. The My Subscriptions page lists your subscriptions.
- Select your subscription. The Subscription summary page opens.
- Click Edit <subscription name>.
How do I get the user key for an application?
- Login to the API Store.
- Select the Subscriptions link at the top right of the page. The My Subscriptions page lists your subscriptions.
- Select the subscription. The Subscription summary page opens.
- See the User Key section. This is the key used in API calls.
How do I regenerate the user key for my application?
- Login to the API Store.
- Select Subscriptions link at the top right of the page .
- Select your subscription. The Subscription summary page opens.
- In the User Key section, click
.
- Make a note of the User Key so you can use it in the API calls.
How do I use the user key?
The user key must be passed in the header rather than the URI as shown in the below example.
curl "https://cipo-gsm-ised-isde-apicast-production.api.canada.ca/app/scr/api/cgs/classes" -H'user-key: 115aaa43e7d95df63d62eecbfab21e8d'
Notes:
- Use the -H or –header option.
- Replace user-key with the user key found in the API Store Subscriptions page in the User Key section.
How do I test a REST API before I subscribe to it?
- Login to the API Store.
- Select the API listing link from the Menu drop down at the top of the page.
- Select the API. The API details page opens.
- Expand the API operations by clicking the operation (for example, GET) or click Expand Operations.
- Enter the required parameters in the Value boxes.
- Click Try it out!