We're happy to let you know that Helthjem has come up with new APIs that will help us keep track of your parcel bookings more accurately. To ensure that you benefit from these improvements, please update your integration with Helthjem using the instructions below.
Authorization LoginV3 API:
Documentation:
The authorization method remains the same - JWT token and Auth0.
Old end-point: https://ws.di.no/ws/json/auth/v-3/login/1440
New PROD:
https://api.helthjem.no/auth/oauth2/v1/tokenNew Pre-PROD:
https://api.pre.helthjem.no/auth/oauth2/v1/tokenIn addition, we also ask that you update your request body with the credentials we have provided to the following:
json{ "client_id": "{{client_id}}", "client_secret": "{{secret}}", "grant_type":"client_credentials" }
- It is not possible to set the token validity time via API. The default validity time for tokens is now 24 hours.
- Previously, the token expiration period could only be obtained from the JWT payload, and we have kept it that way - the
expparameter is still included in the payload. Additionally we include an“expires_in”(in seconds) property in the response body that can be used instead.
Single Address Check API:
Documentation:Single Address Check API
Old end-point: https://ws.di.no/ws/json/addressCheck/single/v-1/find
New PRO:
https://api.helthjem.no/parcels/v1/addresses/find/single
New Pre-PROD: https://api.pre.helthjem.no/parcels/v1/addresses/find/singleNo other modifications are required.
Booking API:
Documentation: Booking API
Old end-point: https://ws.di.no/ws/json/parcel/booking/v-1/book
New:
https://api.helthjem.no/parcels/v1/bookings
New Pre-PROD: https://api.pre.helthjem.no/parcels/v1/bookingsNo other modifications are required.
Event tracking API:
Documentation: Events tracking API
Old end-point: https://ws.di.no/ws/json/parcel/tracking/v-2/fetch/{identifier}/{locale}/{onlyLastEvent}
New PRO:
https://api.helthjem.no/parcels/v1/tracking/fetch/{identifier}/{locale}/{onlyLastEvent}
New Pre-PROD: https://api.pre.helthjem.no/parcels/v1/tracking/fetch/{identifier}/{locale}/{onlyLastEvent}No other modifications are required.
Label API:
Documentation: Label API
Old end-point: https://ws.di.no/ws/json/parcel/label/v-1/labels/{identifier}/unified-large
New PRO:
https://api.helthjem.no//parcels/v1/labels/{identifier}/{type}
New Pre-PROD: https://api.pre.helthjem.no//parcels/v1/labels/{identifier}/{type}No other modifications are required.
Nearby Service Points API:
Documentation:Nearby Service Points API
Old end-point: https://ws.di.no/ws/json/freightcoverage/v-1/servicepoints
New PROD:
https://api.helthjem.no/parcels/v1/service-points/nearby/
New Pre-PROD: https://api.pre.helthjem.no/parcels/v1/service-points/nearby/No other modifications are required.
Get all Service Points API:
Old end-point: https://ws.di.no/ws/json/parcel/servicePoint/v-1/1
New PROD:
https://api.helthjem.no/parcels/v1/service-points/transporter/1
New Pre-PROD: https://api.pre.helthjem.no/parcels/v1/service-points/transporter/1No other modifications are required.
Parcel details API:
Old end-point: https://ws.di.no/ws/json/parcel/booking/v-1/details/{shipmentId}
New PROD:
https://api.helthjem.no/parcels/v1/bookings/details/{shipmentId}
New Pre-PROD: https://api.pre.helthjem.no/parcels/v1/bookings/details/{shipmentId}No other modifications are required.
Parcel Cancel Order API:
Old end-point: https://ws.di.no/ws/json/parcel/booking/v-1/order/cancel/{identifier}
New PROD:
https://api.helthjem.no/parcels/v1/bookings/orders/cancel/{identifier}
New Pre-PROD: https://api.pre.helthjem.no/parcels/v1/bookings/orders/cancel/{identifier}No other modifications are required.
These changes will allow us to provide you with better and more accurate monitoring of your parcel bookings. If you have any questions or concerns, please do not hesitate to contact our technical support team at support@helthjem.com.