API-fejl

Forstå og løs fejl returneret af Zonos GraphQL API.

GraphQL

Zonos API returnerer to typer fejl: HTTP-statuskoder for transportniveau-fejl og GraphQL-fejl for applikationsniveau-problemer. De fleste fejl er GraphQL-fejl, der inkluderer en klassificering i feltet extensions for at hjælpe med at identificere årsagen og den passende løsning.

HTTP-statuskoder

HTTP-fejl returneres, når en anmodning ikke kan behandles på transportniveau.

Statuskode↕	Betydning↕
400	Ugyldigt argument / bad request — anmodningen indeholder ugyldigt input.
401	Unauthorized — ingen gyldige credentials blev angivet.
404	Not found — den anmodede ressource findes ikke.
409	Resource conflict — anmodningen er i konflikt med ressourcens nuværende tilstand.
412	Failed precondition — en påkrævet betingelse var ikke opfyldt før behandling.
422	Unprocessable entity — anmodningens body er strukturelt gyldig, men indeholder ugyldige værdier.
429	Rate limited — for mange anmodninger på kort tid. Brug exponential backoff og prøv igen.
500	Internal server error — en uventet serverfejl opstod. Prøv igen; kontakt support, hvis den vedvarer.
503	Service unavailable — tjenesten er midlertidigt offline. Prøv igen efter kort ventetid.
504	Timeout — serveren modtog ikke svar i tide. Prøv anmodningen igen.

GraphQL-fejlformat

Fejl på applikationsniveau returneres som en liste i feltet errors i response body. Hver fejl inkluderer en message, path for den operation, der fejlede, og et extensions-objekt med fejltypen og request 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}

Fejlklassificeringer

Feltet extensions.errorType angiver fejlkategorien og den anbefalede handling.

Klassificering↕	HTTP-ækvivalent↕	Betydning↕	Handling↕
`BAD_REQUEST`	400	Ugyldigt input eller anmodningsparametre.	Ret anmodningen — tjek påkrævede felter, formater og værdier.
`NOT_FOUND`	404	En refereret ressource findes ikke.	Verificér ID'er, koder og at påkrævede defaults er konfigureret.
`UNAVAILABLE`	503	Den anmodede tjeneste eller mulighed er ikke tilgængelig for denne rute.	Prøv en anden metode, service level eller destination.
`PERMISSION_DENIED`	401 / 403	Godkendelses- eller autorisationsfejl.	Tjek credentials og kontotilladelser.
`FAILED_PRECONDITION`	412	En påkrævet konfiguration eller opsætningsbetingelse var ikke opfyldt.	Tjek org-indstillinger, eller kontakt support.
`INTERNAL`	500	En uventet serverfejl opstod.	Prøv anmodningen igen; kontakt support, hvis problemet vedvarer.
`UNKNOWN`	500	En uventet fejl uden yderligere klassificering.	Verificér anmodningsformat; kontakt support, hvis problemet vedvarer.

Book en demo

API-fejl

HTTP-statuskoder

GraphQL-fejlformat

Fejlklassificeringer

Var denne side nyttig?