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
Start med at oprette ClientID og ClientSecret:
- I nShift Portal skal du gå til Settings > API Configuration > Clients.
- Opret en ny Client, og vælg scope Public Customization API for customers.
-
Save, og husk at notere 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:
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:
Query: forsendelsesnummer
expirationDate: angiv, hvornår URL'en skal udløbe