An API key is a unique identifier used to authenticate an application or user. API keys can be used on account or profile levels.
If you have profile management activated on your account, you can create API keys connected to a specific profile. This API key then uses the profile group of the selected profile to filter out what information you can collect using the API, and where it will be posted.
Note: An API key connected to a specific profile can not be used with the following endpoints: GET /alerts GET /shipments |
Create an API key
- Log into nShift Delivery.
- Go to Maintenance > API keys.
- Click New API key.
- Status should be "Enabled" and Type should be set to "Web Services (REST)".
- Specify what the API key is used for in the Note field. It is recommended to use the Note field as you create multiple API keys.
- Fill in Valid IP addresses if the API key should only be used from certain IP addresses or ranges of IP addresses. The Email field is not used at this time.
- Enter your Developer ID. Normally, the developer ID is your account user ID. But if you have, or are, an ERP, webshop provider or other third party that will post data into the account, it is the user ID of the provider's account.
- Select a Profile in the drop-down menu, if the API key should be connected to a specific profile.
- Click Save.
- The system will automatically generate the key consisting of an ID, a secret ID and a combined ID. It is the ID and the secret ID that you use to authenticate towards the REST API framework.
Use the search function to search for your API keys.