Log ind på dit Zonos Dashboard, og gå til Account →
Integrations. Tabellen viser to nøgler:
Navn i Dashboard↕
Formål↕
Brug til API?↕
Account key
Id til tilknytning med postoperatøren
❌ NEJ
API key
Autentificeringsnøgle til kald til Zonos API
✅ JA — brug denne
Kopiér tokenet i rækken API key. Det begynder med credential_live_. Du skal bruge denne
nøgle til begge integrationsmetoder.
Hold din API-nøgle sikker. Commit den ikke til source control, og del den ikke offentligt. Hvis du
mener, den er kompromitteret, skal du regenerere den fra samme side Account → Integrations.
Item Quoter-værktøjet i dit
Zonos Dashboard giver dig mulighed for at slå estimerede toldomkostninger op for dine produkter, før du sender — nyttigt
til at tjekke satser og planlægge på forhånd uden at generere et Declaration ID.
Vælg den metode, der passer til din tekniske opsætning. Begge metoder producerer Declaration IDs, som du
derefter uploader til Česká poštas forsendelsessystem.
For tekniske kunder og udviklere, der kalder Zonos direkte fra deres eget system.
Endpoint
URL: https://api.zonos.com/graphql
Method: POST
Content-Type: application/json
Autentificering
Send din API-nøgle i headeren credentialToken:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
API-eksempel
Log ind på din Česká pošta-konto for det fulde API-eksempel, inklusive den komplette request og
response.
Efter generering af Declaration IDs
Indsend Declaration ID til Česká pošta sammen med dine forsendelsesdetaljer. Česká pošta knytter
Declaration ID til forsendelsen og returnerer et trackingnummer. Zonos udsteder ikke trackingnumre.
Fejlhåndtering
Fejl / symptom↕
Sandsynlig årsag og løsning↕
Security requirement failed
Din API-nøgle er ugyldig eller sendt i den forkerte header. Sørg for, at du bruger API Key (ikke Account Key), og at headernavnet er præcis credentialToken.
HTTP 401 Unauthorized
API-nøglen mangler i request-headers. Bekræft, at credentialToken er inkluderet.
errors array in response
Mutationen returnerede en GraphQL-fejl. Tjek feltet message i errors-arrayet for detaljer.
Unexpected response shape
Svaret indeholdt ikke data.declarationCreate.id. Log hele response body, og verificer, at mutationsteksten matcher eksemplet præcis.
Kontoopsætning
Kontoopsætning
Opret din Verified Account, tilføj en betalingsmetode, og tilslut din integration.
Trin 1 — Opret din Verified Account
Registrer en Zonos Verified Account via Česká pošta-registreringslinket. Udfyld din virksomhedsadresse og faktureringsopsætning.
Trin 2 — Tilføj en betalingsmetode
Tilføj en betalingsmetode til din Zonos-konto for at finansiere toldremittering for forsendelser til USA.
Trin 3 — Hent din API-nøgle
Log ind på dit Zonos Dashboard, og gå til Account → Integrations. Tabellen viser to nøgler:
Kopiér tokenet i rækken API key. Det begynder med
credential_live_. Du skal bruge denne nøgle til begge integrationsmetoder.Hold din API-nøgle sikker. Commit den ikke til source control, og del den ikke offentligt. Hvis du mener, den er kompromitteret, skal du regenerere den fra samme side Account → Integrations.
Trin 4 (valgfrit) — Estimer toldomkostninger med Item Quoter
Item Quoter-værktøjet i dit Zonos Dashboard giver dig mulighed for at slå estimerede toldomkostninger op for dine produkter, før du sender — nyttigt til at tjekke satser og planlægge på forhånd uden at generere et Declaration ID.
Integrationsmetoder
Vælg den metode, der passer til din tekniske opsætning. Begge metoder producerer Declaration IDs, som du derefter uploader til Česká poštas forsendelsessystem.
For tekniske kunder og udviklere, der kalder Zonos direkte fra deres eget system.
Endpoint
https://api.zonos.com/graphqlapplication/jsonAutentificering
Send din API-nøgle i headeren
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxAPI-eksempel
Log ind på din Česká pošta-konto for det fulde API-eksempel, inklusive den komplette request og response.
Efter generering af Declaration IDs
Indsend Declaration ID til Česká pošta sammen med dine forsendelsesdetaljer. Česká pošta knytter Declaration ID til forsendelsen og returnerer et trackingnummer. Zonos udsteder ikke trackingnumre.
Fejlhåndtering
credentialToken.credentialTokener inkluderet.errorsarray in responsemessagei errors-arrayet for detaljer.data.declarationCreate.id. Log hele response body, og verificer, at mutationsteksten matcher eksemplet præcis.Var denne side nyttig?