Skip to main content

Authorization and access

Before getting started you need to know your developer ID and create an API key.

REST API

REST API requires basic authentication using an API key or custom bearer token based on API key.

The REST API endpoints are only accessible via HTTPS and are located at api.unifaun.com.

https://api.unifaun.com/rs-extapi/v1

Developer ID

Developer ID is your nShift Delivery user ID. It's used as identification to make it easier for nShift to assist and support you.

Note

Being a partner you should always provide your nShift Delivery user ID, not your customer's.

  • REST API - enter developerId (string) in the shipment object.

  • XML - <val n="developerid"> is declared as <meta> element under the root element <data>.

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't be used with the following endpoints:

GET /alerts 

GET /shipments

Create an API key

  1. Log into nShift Delivery.

  2. Go to Maintenance > API keys.

    DEL_MaintenanceAPIkeys_menu-en.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's 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's 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's the ID and the secret ID that you use to authenticate towards the REST API framework.

    DEL_NewAPIkey_page-en.png

Use the search function to search for your API keys.

In this section:

User ID of the account creating the shipment. Normally used by partners when posting data on behalf of others.