Log ind

nShift Help Center

Opret en signeret Tracking URL

Avatar
Malene Tidemann
Opdateret

Det er muligt at generere en signeret tracking-URL ved hjælp af CustomizationAPI. Denne funktion er nyttig, hvis du ønsker et mere sikkert link til tracking-siden. En tracking-URL indeholder typisk ordrenummeret eller stregkoden, men med en signeret URL er disse oplysninger krypteret.


Følg disse trin for at oprette en signeret tracking-URL:

  1. Opret Client ID og Secret
  2. Autentificering
  3. Opret den signerede tracking-URL

 

1. Opret Client ID og Secret

Start med at oprette ClientID og ClientSecret:

  1. I nShift Portal skal du gå til Settings > API Configuration > Clients.
     
  2. Opret en ny Client, og vælg scope Public Customization API for customers.
     
  3. Save, og husk at notere Client Secret.

    client secret

 

For flere oplysninger om generering af ClientID og ClientSecret, klik her.

 

 

2. Autentificering

API'en understøtter Bearer Authentication. Brug ClientID og Client Secret til at hente tokenet.

 

Eksempel på, hvordan du anmoder om et token

curl -X POST "https://account.nshiftportal.com/idp/connect/token" 
--header "Content-Type: application/x-www-form-urlencoded" 
--data-urlencode "grant_type=client_credentials" 
--data-urlencode "client_id={{CLIENT_ID}}" 
--data-urlencode "client_secret={{CLIENT_SECRET}}"


Svar

{
    "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjI3QjA1ODk4Nzc1OEUwMkMI1NiIsInR2...",
    "expires_in": 3600,
    "token_type": "Bearer",
    "scope": "public_api_shipmentserver"
}

Tokenet er gyldigt i 60 minutter, før det udløber, og du skal godkende igen

 

Alle anmodninger skal have tokenet i Authorization-headeren

curl --location "https://api.nshiftportal.com/track/customization/PublicTrackProfile/signedProfile" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer eyJhbGciO..." \
--data "{{PAYLOAD}}"

 

 

3. Opret den signerede Tracking URL

Brug adgangstokenet til at foretage anmodningen.

Se dokumentationen på vores Swagger-side her:

https://api.nshiftportal.com/track/swagger/index.html?urls.primaryName=CustomizationApi

 

Eksempel på anmodning

{
   "profileUuid": "50fc034f-3b4b-472a-ka43-a49d3ab7edff",
   "query": "70730253110028750",
   "expirationDate": "2024-03-10T08:07:47.305Z"
}

 

Eksempel på svar

{
   "url": "https://www.nshiftportal.com/ui/track/?sid=_oOVP-V4pE-v8kfm4k_rKg"
}

 

POST PublicTrackProfile bruges til at oprette en signeret URL til nShift Tracks brandede tracking-side. Læs mere her: Opsætning af en branded tracking-side. Denne artikel indeholder også oplysninger om oprettelse af en offentlig profil.

 

Den ProfileUuid, der skal bruges til PublicTrackProfile, findes under Track > Track > Track Public Profile:

 

Track profileuuid

 

POST PublicProfile bruges til at oprette en signeret URL til Shipment Viewer. Læs mere her: Oprettelse af Shipment Viewer-profiler og offentlige tracking-URL'er. Denne artikel indeholder også oplysninger om oprettelse af en offentlig profil.

 

Den ProfileUuid, der skal bruges til PublicProfile, findes under Track > Settings > Public T&T URL:

 

public T&T profile

 

Query: forsendelsesnummer

expirationDate: angiv, hvornår URL'en skal udløbe

Relaterede artikler