Picture

Getting Started

On this page you will be introduced to the involved steps when establishing an API connection with DSV.

Sign-up

To use the REST API products offered by DSV, you will need to register as a user on the DSV developer portal via the sign-up form.

Note: An email with an activation link will be sent to you after signing up. Please click on the activation link in the email to finalise the registration.

Subscriptions

An overview of available APIs can be found in the top menu under API CATALOGUE. It lists the types of interactions and supported transport modes.

For a detailed explanation of the differences between the individual APIs and capabilities, please refer to the DEVELOPER GUIDE for Air/Sea/Road/Rail and for XPress.

Access to test environment
In the API overview, you will find the test version of each API which must be used when developing against DSV’s APIs.

For each API, a subscribe button is found under the individual API page to request access to the service. When selecting the subscribe button, you will be able to name the subscription for easy reference prior confirming the subscription.

With an approved subscription you get a set of authentication details which is required to call each API. For additional information about the authentication details, please refer to the Developer guide  for Air/Sea/Road/Rail and for XPress

Access to production environment
Please refer to the Go-live section.

Note: When subscribing to an API, an approval/verification process is activated at DSV. The APIs can only be used once the subscription request is approved by DSV. DSV will revert on your requests as quickly as possible.

Development and Test

Technical documentation for the individual APIs is found in the top menu under API CATALOGUE by selecting the relevant API.

On the technical page, you will find a detailed explanation of the API with involved variables, authentication process, responses and examples of examples of cURL commands and other programming languages.

Schema of the APIs can be viewed on the individual API page with the option to download these as OpenAPI (OAS3) specifications.

To simplify the implementation, a ‘Try It’ button is made available on each API page to simulate the response from our system based on the various variables (parameters, payload and headers) provided by your system.

Bookings submitted in the test setup can be viewed in the online demo portals for Air/Sea/Road/Rail and for XPress. Login credentials for the portals are provided via email upon approval of the subscription request.

A POSTMAN collection with scenarios and sample structure for each API is made available in the Developer guide for Air/Sea/Road/Rail to speed up the implementation.

Note: It is important that all test requests are made against DSV’s test APIs prior establishing the production connection.

Certification process (for selective APIs)

Certain API products (the XPress Booking API) require you to pass a certification process, as a prerequisite for moving to Production.

Please refer to the Certification tests section in the Developer guide for a detailed explanation of the involved steps.

Note: All required certification tests for the XPress Booking API have to be passed prior requesting Go-live.

Go-Live

After successfully testing the setup against DSV’s test APIs and passing the certification process (if using the XPress Booking API), simply perform the following steps:

  1. Create a User on the DSV Developer portal which will be used for the production setup. This user will be contacted for relevant updates related to the APIs incl. version updates, maintenance, new APIs and more.

  2. Send an email to the DSV API team via the SUPPORT page and specify which API(s) you are ready to go-live with and request access to DSV's production environment.

Based on the request, we will configure the account and provide you with the related API key, Authentication details and production URLs required to get access to our production system.

Note: During this process, DSV may contact you for additional information to finalise the setup.

Support

Should you encounter problems during the implementation, or if you have input or questions to the technical documentation, you can always contact us via the menu item SUPPORT.