API-feil

Forstå og løs feil som returneres av Zonos GraphQL API.

GraphQL

Zonos API returnerer to typer feil: HTTP-statuskoder for transportnivåfeil, og GraphQL-feil for applikasjonsnivåfeil. De fleste feil er GraphQL-feil som inkluderer en klassifisering i extensions-feltet for å hjelpe deg med å identifisere årsaken og passende løsning.

HTTP-statuskoder

HTTP-feil returneres når en forespørsel ikke kan behandles på transportnivået.

Statuskode↕	Betydning↕
400	Ugyldig argument / dårlig forespørsel — forespørselen inneholder ugyldig inndata.
401	Uautorisert — ingen gyldige legitimasjonsdokumenter ble gitt.
404	Ikke funnet — den forespurte ressursen eksisterer ikke.
409	Ressurskonflikt — forespørselen er i konflikt med gjeldende tilstand for en ressurs.
412	Mislykket forutsetning — en påkrevd betingelse ble ikke oppfylt før behandlingen.
422	Umulig å behandle enhet — forespørselsteksten er strukturelt gyldig men inneholder ugyldige verdier.
429	Begrenset — for mange forespørsler på kort tid. Bruk eksponentiell backoff og prøv igjen.
500	Intern serverfeil — en uventet feil på serveren oppstod. Prøv igjen; kontakt support hvis vedvarende.
503	Tjeneste utilgjengelig — tjenesten er midlertidig offline. Prøv igjen etter en kort pause.
504	Timeout — serveren mottok ikke svar i tide. Prøv forespørselen igjen.

GraphQL-feilformat

Applikasjonsnivåfeil returneres som en liste i errors-feltet i responsekroppen. Hver feil inkluderer en message, path-en for operasjonen som mislyktes, og et extensions-objekt med feiltypen og forespørsel-ID.

1{

2 "errors": [

3 {

4 "message": "Description of the error",

5 "path": [

6 "landedCostCalculate"

7 ],

8 "extensions": {

9 "errorType": "BAD_REQUEST",

10 "requestId": "req_abc123"

11 }

12 }

13 ]

14}

Feilklassifiseringer

extensions.errorType-feltet angir kategori for feilen og den anbefalte handlingen.

Klassifisering↕	HTTP-ekvivalent↕	Betydning↕	Handling↕
`BAD_REQUEST`	400	Ugyldig inndata eller forespørselparametere.	Rett forespørselen — sjekk påkrevde felt, formater og verdier.
`NOT_FOUND`	404	En referert ressurs eksisterer ikke.	Bekreft ID-er, koder, og at påkrevde standarder er konfigurert.
`UNAVAILABLE`	503	Den forespurte tjenesten eller alternativet er ikke tilgjengelig for denne ruten.	Prøv en annen metode, servicenivå eller destinasjon.
`PERMISSION_DENIED`	401 / 403	Autentiserings- eller autorisasjonsfeil.	Sjekk legitimasjonsdokumenter og kontotillatelser.
`FAILED_PRECONDITION`	412	En påkrevd konfigurasjons- eller oppsettbetingelse ble ikke oppfylt.	Sjekk organisasjonsinnstillinger eller kontakt support.
`INTERNAL`	500	En uventet feil på serveren oppstod.	Prøv forespørselen igjen; kontakt support hvis problemet vedvarer.
`UNKNOWN`	500	En uventet feil uten videre klassifisering.	Bekreft forespørselformat; kontakt support hvis problemet vedvarer.

Bestill en demo

API-feil

HTTP-statuskoder

GraphQL-feilformat

Feilklassifiseringer

Var denne siden nyttig?