Connecting to the DHL API
Update
After seeing more and more interest in integrating DHL in Parabola, we turned this post into a comprehensive guide found here. Check out that post for additional information!
Original Post
Getting Started
Before diving in, we recommend exploring DHL’s API catalog to ensure that their API supports the specific use case you have in mind. Different APIs have different auth types/set up processes, so we also recommend familiarizing yourself with the specific API before jumping in.
Creating an Application
To begin using DHL APIs, you first need to create an application. This process will provide you with the necessary API credentials for the Authentication process.
If you’re working with an API that leverages authentication via headers (like their Shipment Tracking - Unified API), once you’ve created your app, you’ll need to find your ‘subscription key’ for your API call. Per DHL’s documentation…
To view your API subscription keys:
- From the My Apps screen, click on the name of your app.
The Details screen appears.- If you have access to more than one API, click the name of the relevant API.
Note: The APIs are listed under the “Credentials” section.- Click the Show link below the asterisks that is hiding the Consumer Key.
For certain APIs (like the Freight Sales Invoice Push API) the process will be a bit different. If you need to set up a subscription feed for your API, follow Parabola’s documentation for generating a unique webhook URL to receive data.
Authentication
To authenticate most DHL API calls, we’ll need to pass this key through a request header called DHL-API-Key
. In your Parabola API step, create a request header and paste in your key:
Leveraging the DHL API
With your API key good to go, you can start connecting to specific DHL API endpoints (tip: click the bolded name of the API to explore).
Additional Information
- Some DHL functionalities are exclusive to their online platform and not available via API. For example, you cannot raise a dispute through the API.
Questions?
Feel free to reach out to help@parabola.io with any specific questions about DHL’s API or drop a comment in this post!