Logg inn på Zonos Dashboard og gå til Konto →
Integrasjoner. Tabellen viser to nøkler:
Navn i Dashboard↕
Formål↕
Bruk for API?↕
Kontonøkkel
Identifikator for kobling med postoperatøren
❌ NEI
API-nøkkel
Autentiseringsnøkkel for å kalle Zonos API
✅ JA — bruk denne
Kopier tokenet i raden API-nøkkel. Det begynner med credential_live_. Du trenger denne
nøkkelen for begge integrasjonsmetoder.
Oppbevar API-nøkkelen din sikkert. Ikke commit den til versjonskontroll eller del den offentlig. Hvis du
tror den er blitt kompromittert, generer den på nytt fra samme Konto → Integrasjoner side.
Verktøyet Item Quoter i
Zonos Dashboard lar deg slå opp estimerte tollgebyr for produktene dine før forsendelse — nyttig
for å kontrollere satser og planlegge fremover uten å generere en erklærings-ID.
Velg metoden som passer ditt tekniske oppsett. Begge metodene produserer erklærings-IDer som du
deretter laster opp til Česká postas fraktesystem.
For tekniske kunder og utviklere som ringer Zonos direkte fra sitt eget system.
Sluttpunkt
URL: https://api.zonos.com/graphql
Metode: POST
Content-Type: application/json
Autentisering
Send API-nøkkelen din i credentialToken-headeren:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
API-eksempel
Logg inn på Česká pošta-kontoen din for det fullstendige API-eksemplet, inkludert komplett forespørsel og
svar.
Etter generering av erklærings-IDer
Send erklærings-ID-en til Česká pošta sammen med forsendelsesdetaljer. Česká pošta knytter
erklærings-ID-en til forsendelsen og returnerer et sporingsnummer. Zonos utsteder ikke sporingsnumre.
Feilhåndtering
Feil / Symptom↕
Sannsynlig årsak og løsning↕
Sikkerhetskravet mislyktes
API-nøkkelen er ugyldig eller sendt i feil header. Sørg for at du bruker API-nøkkelen (ikke Kontonøkkelen) og at headernavnet er nøyaktig credentialToken.
HTTP 401 Uautorisert
API-nøkkelen mangler fra forespørselsheaderne. Bekreft at credentialToken er inkludert.
errors-array i svar
Mutasjonen returnerte en GraphQL-feil. Sjekk message-feltet i errors-arrayet for detaljer.
Uventet svarsform
Svaret inkluderte ikke data.declarationCreate.id. Logg hele responsteksten og bekreft at mutasjonsteksten samsvarer nøyaktig med eksemplet.
Kontooppsett
Kontooppsett
Opprett din verifiserte konto, legg til en betalingsmetode, og koble til integrasjonen din.
Trinn 1 — Opprett din verifiserte konto
Registrer deg for en Zonos-verifisert konto ved å bruke Česká pošta registreringslenke. Fullfør forretningsadressen og fakturaoppsettet.
Trinn 2 — Legg til en betalingsmetode
Legg til en betalingsmetode på Zonos-kontoen din for å finansiere tollavgift for forsendelser til USA.
Trinn 3 — Hent API-nøkkelen din
Logg inn på Zonos Dashboard og gå til Konto → Integrasjoner. Tabellen viser to nøkler:
Kopier tokenet i raden API-nøkkel. Det begynner med
credential_live_. Du trenger denne nøkkelen for begge integrasjonsmetoder.Oppbevar API-nøkkelen din sikkert. Ikke commit den til versjonskontroll eller del den offentlig. Hvis du tror den er blitt kompromittert, generer den på nytt fra samme Konto → Integrasjoner side.
Trinn 4 (valgfritt) — Estimer tollkostnader med Item Quoter
Verktøyet Item Quoter i Zonos Dashboard lar deg slå opp estimerte tollgebyr for produktene dine før forsendelse — nyttig for å kontrollere satser og planlegge fremover uten å generere en erklærings-ID.
Integrasjonsmetoder
Velg metoden som passer ditt tekniske oppsett. Begge metodene produserer erklærings-IDer som du deretter laster opp til Česká postas fraktesystem.
For tekniske kunder og utviklere som ringer Zonos direkte fra sitt eget system.
Sluttpunkt
https://api.zonos.com/graphqlapplication/jsonAutentisering
Send API-nøkkelen din i
credentialToken-headeren:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxAPI-eksempel
Logg inn på Česká pošta-kontoen din for det fullstendige API-eksemplet, inkludert komplett forespørsel og svar.
Etter generering av erklærings-IDer
Send erklærings-ID-en til Česká pošta sammen med forsendelsesdetaljer. Česká pošta knytter erklærings-ID-en til forsendelsen og returnerer et sporingsnummer. Zonos utsteder ikke sporingsnumre.
Feilhåndtering
credentialToken.credentialTokener inkludert.errors-array i svarmessage-feltet i errors-arrayet for detaljer.data.declarationCreate.id. Logg hele responsteksten og bekreft at mutasjonsteksten samsvarer nøyaktig med eksemplet.Var denne siden nyttig?