API-fel

Förstå och åtgärda fel som returneras av Zonos GraphQL API.

GraphQL

Zonos API returnerar två typer av fel: HTTP-statuskoder för fel på transportnivå och GraphQL-fel för problem på applikationsnivå. De flesta fel är GraphQL-fel som inkluderar en klassificering i fältet extensions för att hjälpa er att identifiera orsaken och lämplig åtgärd.

HTTP-statuskoder

HTTP-fel returneras när en begäran inte kan bearbetas på transportnivå.

Statuskod↕	Betydelse↕
400	Ogiltigt argument / felaktig begäran — begäran innehåller ogiltig indata.
401	Obehörig — inga giltiga autentiseringsuppgifter angavs.
404	Hittades inte — den begärda resursen finns inte.
409	Resurskonflikt — begäran står i konflikt med resursens aktuella tillstånd.
412	Misslyckad förutsättning — ett nödvändigt villkor uppfylldes inte före bearbetning.
422	Obearbetbar entitet — begärans body är strukturellt giltig men innehåller ogiltiga värden.
429	Hastighetsbegränsad — för många begäranden under en kort period. Använd exponentiell backoff och försök igen.
500	Internt serverfel — ett oväntat fel på serversidan inträffade. Försök igen; kontakta support om det kvarstår.
503	Tjänsten otillgänglig — tjänsten är tillfälligt offline. Försök igen efter en kort fördröjning.
504	Timeout — servern fick inte svar i tid. Skicka om begäran.

GraphQL-felformat

Fel på applikationsnivå returneras som en lista i fältet errors i svarskroppen. Varje fel inkluderar ett message, path för den operation som misslyckades och ett extensions-objekt med feltyp och 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}

Felklassificeringar

Fältet extensions.errorType anger felkategorin och rekommenderad åtgärd.

Klassificering↕	HTTP-motsvarighet↕	Betydelse↕	Åtgärd↕
`BAD_REQUEST`	400	Ogiltig indata eller begärandeparametrar.	Åtgärda begäran — kontrollera obligatoriska fält, format och värden.
`NOT_FOUND`	404	En refererad resurs finns inte.	Verifiera ID:n, koder och att obligatoriska standardvärden är konfigurerade.
`UNAVAILABLE`	503	Den begärda tjänsten eller alternativet är inte tillgängligt för den här rutten.	Prova en annan metod, tjänstenivå eller destination.
`PERMISSION_DENIED`	401 / 403	Autentiserings- eller auktoriseringsfel.	Kontrollera autentiseringsuppgifter och kontobehörigheter.
`FAILED_PRECONDITION`	412	Ett nödvändigt konfigurations- eller installationsvillkor uppfylldes inte.	Kontrollera organisationsinställningar eller kontakta support.
`INTERNAL`	500	Ett oväntat fel på serversidan inträffade.	Skicka om begäran; kontakta support om problemet kvarstår.
`UNKNOWN`	500	Ett oväntat fel utan ytterligare klassificering.	Verifiera begärans format; kontakta support om problemet kvarstår.

Boka en demo

API-fel

HTTP-statuskoder

GraphQL-felformat

Felklassificeringar

Var den här sidan till hjälp?