Skip to main content

nShift Delivery Help Center

API keys

An API key is a unique identifier used to authenticate an application or user.

API keys can be used on account or profile level.

Notice

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.

Caution

An API key connected to a specific profile can not be used with the following endpoints:

GET /alerts 

GET /shipments

Create an API key

  1. Log in to nShift Delivery.

  2. Go to Maintenance > API keys.

    UO_Maintenance_API_keys.png
  3. Click New API key.

  4. Status should be "Enabled".

  5. Type should be set to "Web Services (REST)".

  6. specify what the API key is used for in the Note field.

    Tip

    As you can create multiple API keys, it is recommended to use the Note field.

  7. Enter Valid IP addresses if the API key should only be used from certain IP addresses or ranges of IP addresses.

  8. The Email field is not used at this time.

  9. Enter your Developer ID.

    Note

    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.

  10. Select a Profile in the drop-down menu, if the API key should be connected to a specific profile.

  11. 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.

    UO_New_API_key.png

Use the search function to search for your API keys.