Din första Tracking API-begäran: en genomgång av en REST-klient med Postman och Curl
För att göra din första tracking-API-förfrågan konfigurerar du endpointen, autentiseringshuvudet och JSON-kroppen i en REST-klient, skickar förfrågan och granskar både HTTP-statusen och svarskroppen. Den här genomgången använder 17TRACK’s Tracking API för att visa samma arbetsflöde i Postman och curl: registrera en försändelse, begära dess spårningsinformation och kontrollera om resultatet är klart att användas av din applikation.

Målet är ett litet, reproducerbart integrationstest – inte en produktionsdistribution. Du behöver en API-behörighet och ett spårningsnummer som du har rätt att behandla. Kommandona nedan använder endpointmönstret v2.2; bekräfta endpointversionen och kontospecifika krav i 17TRACK API-dokumentationen innan du kör dem.
Förstå vad din första förfrågan ska åstadkomma
En integration för försändelsespårning har två separata delar: att tala om för tjänsten vilken försändelse som ska spåras och att hämta spårningsinformationen som hör till den försändelsen. I arbetsflödet som visas här är detta separata förfrågningar. Registrering innebär inte att paketet redan har skickats, och en lyckad registrering garanterar inte att transportörens händelser är tillgängliga omedelbart.
Använd en försändelse i stället för en batch i ditt första test. Då blir det enklare att isolera autentiseringsfel, ogiltiga spårningsnummer och tolkning av svar. Din första användbara milstolpe är inte bara ”Jag fick HTTP 200”. Den är ”API:et accepterade den avsedda åtgärden, och jag kan förklara resultatet på försändelsenivå”.
Postman ger dig ett visuellt gränssnitt för att redigera förfrågningar och granska svar. curl gör samma HTTP-utbyte reproducerbart från en terminal. Ingen av dem ändrar API:ets autentiseringsregler, försändelsedata eller bearbetningsbeteende. Använd det verktyg som hjälper dig att undersöka förfrågan tydligast och återskapa sedan den fungerande konfigurationen i det andra verktyget.
Förbered din behörighet, försändelse och information om förfrågan
Samla in följande innan du öppnar någon av klienterna:
- En auktoriserad API-behörighet: skaffa den genom konfigurationen av ditt 17TRACK API-konto. En konsumentspårningssession ersätter inte en API-behörighet.
- Ett verkligt spårningsnummer: använd en försändelse som du äger eller har tillstånd att komma åt. En nyligen aktiv försändelse är i allmänhet mer användbar än ett påhittat nummer när du testar verkliga spårningsdata.
- Transportören, om den är känd: ha transportörens namn tillgängligt för felsökning. Om en transportörsidentifierare krävs i ditt fall ska du använda det värde och fält som definieras i API-dokumentationen i stället för att gissa.
- Det aktuella förfrågningskontraktet: bekräfta API-version, autentiseringshuvud, förfrågningsschema och eventuella kontobegränsningar.
- En säker arbetsyta: undvik att placera behörigheter, kunduppgifter eller fullständiga spårningssvar i offentliga arkiv, skärmbilder eller delade supportmeddelanden.
De minimala förfrågningsexemplen använder dessa inställningar:
| Inställning | Exempelkonfiguration |
|---|---|
| Base URL | https://api.17track.net/track/v2.2 |
| Registreringsåtgärd | POST /register |
| Åtgärd för spårningsinformation | POST /gettrackinfo |
| Autentiseringshuvud | 17token: YOUR_API_TOKEN |
| Kroppsformat | Content-Type: application/json, med en JSON-array av försändelseobjekt |
Behåll spårningsnummer som strängar. Om du konverterar ett till en numerisk typ kan inledande nollor försvinna eller värdet ändras på annat sätt. Platshållaren YOUR_TRACKING_NUMBER nedan måste ersättas med din faktiska testförsändelse; det är inte ett fungerande exempelnummer.
Skapa registreringsförfrågan i Postman
1. Skapa en liten testmiljö
I Postman skapar du en miljö med tre variabler: base_url, tracking_token och tracking_number. Ställ in base_url på ovanstående bas-URL och ange din behörighet och ditt försändelsenummer i de andra variablerna. Välj miljön innan du skickar förfrågan.
Använd Postmans tillgängliga kontroller för säker hantering av hemligheter för token och kontrollera vad din arbetsyta delar eller synkroniserar. Att dölja ett värde i gränssnittet ersätter inte kontrollen över vem som kan komma åt det. Exportera inte ifyllda behörigheter tillsammans med en samling som är avsedd för kollegor eller offentlig dokumentation.
2. Konfigurera metod, URL och headers
Skapa en HTTP-förfrågan, välj POST och ange {{base_url}}/register som URL. Lägg till följande på fliken Headers:
17token: {{tracking_token}}
Content-Type: application/jsonI det här exemplet ska behörigheten finnas i det anpassade huvudet 17token. Ersätt det inte med en Bearer-tokenkonfiguration bara för att ett annat API använde det mönstret. Kontrollera också om ärvda samlingsinställningar lägger till ett oavsiktligt Authorization-huvud.
3. Lägg till JSON-kroppen
Öppna Body, välj raw och sedan JSON. Ange:
[
{
"number": "{{tracking_number}}"
}
]De yttre hakparenteserna är viktiga: den här förfrågan använder en array även om den bara innehåller en försändelse. Använd dubbla citationstecken, ta bort avslutande kommatecken och placera inga kommentarer i JSON. Om dokumentationen kräver ytterligare information för din transportör eller försändelse ska du lägga till de dokumenterade fälten innan du skickar.
4. Skicka och granska resultatet
Klicka på Send. Kontrollera först om du över huvud taget fick ett HTTP-svar. Ett DNS-fel, TLS-fel, proxyproblem eller timeout skiljer sig från ett svar som förklarar att förfrågan var ogiltig. Granska sedan svarskroppen för åtgärdens resultat och eventuell information om godkännande eller avvisning på försändelsenivå.
Återskapa förfrågan med curl
Följande kommandon använder ett POSIX-liknande skal, till exempel Bash eller Zsh. PowerShell och Windows Command Prompt har andra regler för citationstecken och variabler. I PowerShell använder du vid behov curl.exe för att anropa curl-körfilen i stället för ett skalspecifikt kommandoalias.
Ställ in bas-URL:en och läs in din behörighet i en miljövariabel enligt ditt normala arbetsflöde för hemlighetshantering:
export TRACKING_BASE_URL='https://api.17track.net/track/v2.2'
# Set TRACKING_API_TOKEN securely before continuing.En miljövariabel håller behörigheten utanför det återanvändbara exemplet, men är inte ett fullständigt system för hemlighetshantering. Undvik vid lokala tester att skriva in en verklig token i ett kommando som sparas i skals historik. För automatisering använder du plattformens hemlighetslager och begränsar loggutdata.
Skapa en fil med namnet shipment.json och ersätt platshållaren med ditt testspårningsnummer:
[
{
"number": "YOUR_TRACKING_NUMBER"
}
]Skicka registreringsförfrågan:
curl --request POST \
--url "$TRACKING_BASE_URL/register" \
--header "17token: $TRACKING_API_TOKEN" \
--header 'Content-Type: application/json' \
--data-binary @shipment.json \
--connect-timeout 10 \
--max-time 30 \
--silent --show-error \
--output register-response.json \
--write-out 'HTTP status: %{http_code}\n'Detta sparar svarskroppen i register-response.json och skriver ut HTTP-statusen separat. Anslutnings- och total-timeout är lokala testval, inte garantier från 17TRACK-tjänsten. Öppna den sparade filen för att granska API-resultatet; statusraden ensam är otillräcklig.
curl kan slutföra en överföring även när servern returnerar ett HTTP-felsvar. Omvänt kan ett transportfel göra att inget användbart API-svar anländer. När du skriptar ska du hantera curls exit-status, HTTP-statusen och resultatet på applikationsnivå som separata signaler.
Begär försändelsens spårningsinformation
När registreringen har bekräftats duplicerar du Postman-förfrågan och ändrar URL:en till {{base_url}}/gettrackinfo. Behåll POST-metoden, autentiseringshuvudet, innehållstypen och försändelsekroppen. Spara den separat så att du inte råkar registrera försändelsen igen när du egentligen vill hämta data.
Motsvarande curl-förfrågan är:
curl --request POST \
--url "$TRACKING_BASE_URL/gettrackinfo" \
--header "17token: $TRACKING_API_TOKEN" \
--header 'Content-Type: application/json' \
--data-binary @shipment.json \
--connect-timeout 10 \
--max-time 30 \
--silent --show-error \
--output tracking-response.json \
--write-out 'HTTP status: %{http_code}\n'Anta inte att en nyregistrerad försändelse omedelbart returnerar en fullständig händelsehistorik. Datatillgängligheten beror på försändelsen och tjänstens bearbetning. Om information ännu inte är tillgänglig följer du den dokumenterade vägledningen för hämtning och uppdatering i stället för att upprepade gånger registrera samma nummer eller köra en tät polling-loop.
Läs svaret i tre lager
- Transport: anslöt klienten och tog emot ett HTTP-svar?
- Åtgärd: accepterade API:et förfrågan och lyckades den enskilda försändelsen?
- Försändelseinformation: identifierar de returnerade uppgifterna den avsedda försändelsen, och vad fastställer dess status eller händelsehistorik faktiskt?
Använd det officiella svarsschemat för att hitta fält för status, transportör och händelser. Bevara skillnaden mellan en normaliserad försändelsestatus och transportörens ursprungliga händelsebeskrivning. En lyckad sökning är inte bevis på leverans, och saknade händelser är inte bevis på att ett paket har gått förlorat.
Felsök utan att ändra allt på en gång
- Inget svar: kontrollera värdnamn, nätverksåtkomst, proxyinställningar, TLS-konfiguration och lokal timeout. Inaktivera inte certifikatverifiering som rutinlösning.
- Autentiseringsfel: bekräfta att token är aktiv, att huvudet
17tokenfinns och att den valda Postman-miljön löser variabeln korrekt. Kontrollera oavsiktliga blanksteg. - Ogiltig förfrågan: verifiera API-version, åtgärdssökväg, POST-metod, innehållstyp och JSON-arrayens struktur mot dokumentationen.
- Försändelsen avvisades: läs det försändelsespecifika felet. Kontrollera numret och eventuell obligatorisk transportörsinformation i stället för att behandla varje avvisning som ett autentiseringsproblem.
- Inga spårningshändelser: bekräfta registreringen och den avsedda försändelsens identitet. Kontrollera om transportörsinformation behövs och om uppdateringar är tillgängliga innan du försöker igen.
- Postman fungerar men curl misslyckas: jämför den upplösta URL:en, de faktiska headers och body-byten. Skalcitering och ej inställda miljövariabler är vanliga orsaker till att förfrågningarna skiljer sig åt.
Vanliga frågor
Kan jag testa utan ett verkligt spårningsnummer?
Du kan testa viss validering av förfrågningar med ett ogiltigt värde, men det verifierar inte försändelsespårning. Om du vill testa verkliga händelser använder du en auktoriserad försändelse eller en dokumenterad test-fixture om tjänsten tillhandahåller en sådan. Anta inte att godtyckliga exempelnummer tillhör en sandbox.
Varför innehåller ett HTTP 200-svar fortfarande ett fel?
HTTP-status och applikationsresultat beskriver olika lager. En server kan ta emot och bearbeta en förfrågan framgångsrikt samtidigt som den rapporterar att en enskild försändelse avvisades. Läs svarskroppen och det dokumenterade resultatet på försändelsenivå, inte bara HTTP-statusen.
Varför används POST för att hämta spårningsinformation?
Använd den metod som anges i endpointkontraktet. Det här hämtnings例emplet accepterar försändelseidentifierare i en JSON-förfrågningskropp via POST. Att ändra den till GET eftersom åtgärden läser data bevarar inte den dokumenterade förfrågan.
Bör jag lägga API-token i JavaScript i webbläsaren?
Bädda inte in en privat API-behörighet i offentligt levererad frontend-kod. Dirigera förfrågningar genom en auktoriserad backend som skyddar behörigheten, validerar indata och styr vilken försändelseinformation varje användare får åtkomst till.
Behöver jag både Postman och curl i produktion?
Nej. De är användbara test- och diagnostikverktyg. Din produktionsapplikation kan använda en lämplig HTTP-klient. Behåll en sanerad Postman-förfrågan eller ett curl-kommando som reproducerbar referens, utan en aktiv token eller onödiga kunduppgifter.
Källor
- 17TRACK API-dokumentation — referens för autentisering, endpointkontrakt, förfrågningsfält, svarstolkning och integrationskrav.
- Postman-dokumentation: Skicka API-förfrågningar — konfiguration av förfrågningar och granskning av svar.
- Postman-dokumentation: Variabler — variabelbaserad konfiguration av förfrågningar.
- curl-manual — kommandoalternativ för headers, förfrågningskroppar, timeouts, sparade svar och utskrift av HTTP-status.


