Denna artikel förklarar hur man hämtar en platskod (t.ex. terminal- eller platskod såsom 9010 eller 0705) från försändelsehändelser när man arbetar med ShipmentData API. Fokus ligger på att identifiera var datan finns i svaret och hur man tolkar den.
Autentiseringsförutsättningar
Innan du anropar ShipmentData API behöver du en access-token:
- Auth URL:
https://account.nshiftportal.com/idp/connect/token - Grant type:
client_credentials - Scope:
public_api_portal_shipment_data
När du byter ut ditt client_id och client_secret mot en token, använder du den token i Authorization: Bearer-huvudet för dina API-anrop.
Steg 1: Hämta en access-token
Använd cURL för att få din access-token:
curl -X POST 'https://account.nshiftportal.com/idp/connect/token'
-H 'Content-Type: application/x-www-form-urlencoded'
-d 'grant_type=client_credentials'
-d 'client_id=<YOUR_CLIENT_ID>'
-d 'client_secret=<YOUR_CLIENT_SECRET>'Exempelsvar:
{
"access_token": "<JWT>",
"expires_in": 3600,
"token_type": "Bearer",
"scope": "public_api_portal_shipment_data"
}
Steg 2: Fråga efter försändelsedata via streckkod
För att hämta händelser som kan innehålla platskoder, använd endpointen Aggregated-by-Barcode.
curl -X POST 'https://api.nshiftportal.com/track/shipmentdata/Operational/Shipments/Aggregated/ByBarcode'
-H "Authorization: Bearer <ACCESS_TOKEN>"
-H "Content-Type: application/json"
-d '{
"query": "<BARCODE>",
"startDate": "2025-08-24T00:00:00Z",
"endDate": "2025-08-26T23:59:59Z",
"pageSize": 20,
"pageIndex": 0,
"installationTags": [],
"actorTags": [],
"carrierTags": [],
"dateRangeSource": 1
}'Svaret inkluderar information på försändelse- och paketnivå, inklusive händelser.
Var platskoden visas
location-fältet ingår i vissa paketnivåhändelser. Det representerar vanligtvis en transportörs interna plats- eller terminalkod.
- Paketnivåhändelser:
shipment.lines[].packages[].events[].location(föredras)
När location finns visas det tillsammans med:
cityNamepostalCodecountryValfritt,
coordinatesmed latitud och longitud
Exempel: utdrag från svar
Nedan är ett förenklat exempel på ett svar som visar en pakethändelse med en platskod:
[
{
"shipment": {
"lines": [
{
"packages": [
{
"number": "00073123400271295954",
"events": [
{
"uuid": "b4e5a99b-0aee-41a2-11dd-b1e539a1a4d1",
"configurationName": "The delivery of the shipment item is in progress",
"normalizedStatusId": 2001,
"normalizedStatusName": "Out for delivery",
"date": "2025-08-26T09:16:14+02:00",
"cityName": "Aalborg",
"postalCode": "9000",
"country": "Denmark",
"location": "9010"
}
]
}
]
}
]
}
}
]
I detta exempel:
location-koden är 9010- Händelsestatus är Utleverans pågår
- Stad och postnummer ger ytterligare kontext (Aalborg, 9000)
Tolka platskoden
location-värdet är specifikt för transportören, inte ett postnummer.- Koder som
9010eller0705är identifierare för terminaler eller sorteringsnav. - Kombinera med
cityNameochpostalCodeför att ge användarna en tydligare bild.