Logga in

nShift Help Center

Skapa en signerad Tracking URL

Avatar
Malene Tidemann
Uppdaterad

Det är möjligt att generera en signerad spårnings-URL med CustomizationAPI. Den här funktionen är användbar om du vill ha en säkrare länk till spårningssidan. Vanligtvis innehåller en spårnings-URL ordernumret eller streckkoden, men med en signerad URL krypteras denna information.


Följ dessa steg för att skapa en signerad spårnings-URL:

  1. Skapa Client ID och Secret
  2. Autentisera
  3. Skapa den signerade spårnings-URL:en

 

1. Skapa Client ID och Secret

Börja med att skapa ClientID och ClientSecret:

  1. I nShift Portal går du till Settings > API Configuration > Clients.
     
  2. Skapa en ny Client och välj scope Public Customization API for customers.
     
  3. Save och kom ihåg att anteckna Client Secret.

    client secret

 

För mer information om att generera ClientID och ClientSecret, klicka här.

 

 

2. Autentisera

API:et stöder Bearer Authentication. Använd ClientID och Client Secret för att hämta tokenet.

 

Exempel på hur du begär ett 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 är giltigt i 60 minuter innan det löper ut och du måste autentisera igen

 

Alla begäranden måste ha tokenet i Authorization-headern

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

 

 

3. Skapa den signerade Tracking URL:en

Använd åtkomsttokenet för att göra begäran.

Se dokumentationen på vår Swagger-sida här:

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

 

Exempelbegäran

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

 

Exempelsvar

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

 

POST PublicTrackProfile används för att skapa en signerad URL till nShift Tracks varumärkesanpassade spårningssida. Läs mer här: Konfigurera en varumärkesanpassad spårningssida. Den här artikeln innehåller även information om hur du skapar en offentlig profil.

 

Den ProfileUuid som behövs för PublicTrackProfile finns under Track > Track > Track Public Profile:

 

Track profileuuid

 

POST PublicProfile används för att skapa en signerad URL till Shipment Viewer. Läs mer här: Skapa Shipment Viewer-profiler och offentliga spårnings-URL:er. Den här artikeln innehåller även information om hur du skapar en offentlig profil.

 

Den ProfileUuid som behövs för PublicProfile finns under Track > Settings > Public T&T URL:

 

public T&T profile

 

Query: sändningsnummer

expirationDate: ange när URL:en ska löpa ut

Relaterade artiklar