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. |
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.