Codici di stato HTTP
Gli errori HTTP vengono restituiti quando una richiesta non può essere elaborata a livello di trasporto.
| Codice stato↕ | Significato↕ |
|---|---|
| 400 | Argomento non valido/richiesta errata: la richiesta contiene input non validi. |
| 401 | Non autorizzato: non sono state fornite credenziali valide. |
| 404 | Non trovato: la risorsa richiesta non esiste. |
| 409 | Conflitto di risorse: la richiesta è in conflitto con lo stato corrente di una risorsa. |
| 412 | Precondizione non riuscita: una condizione richiesta non è stata soddisfatta prima dell'elaborazione. |
| 422 | Entità non elaborabile: il corpo della richiesta è strutturalmente valido ma contiene valori non validi. |
| 429 | Rate limitato: troppe richieste in un breve periodo. Utilizzare il backoff esponenziale e riprovare. |
| 500 | Errore interno del server: si è verificato un errore imprevisto sul lato server. Riprova; contattare l'assistenza se persistente. |
| 503 | Servizio non disponibile: il servizio è temporaneamente offline. Riprovare dopo un breve ritardo. |
| 504 | Timeout: il server non ha ricevuto una risposta in tempo. Riprovare la richiesta. |
Formato errore GraphQL
Gli errori a livello di applicazione vengono restituiti come elenco nel campo errors del corpo della risposta. Ogni errore include un message, il path dell'operazione non riuscita e un oggetto extensions con il tipo di errore e l'ID della richiesta.
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
}Classificazioni degli errori
Il campo extensions.errorType indica la categoria dell'errore e l'azione consigliata.
| Classificazione↕ | Equivalente HTTP↕ | Significato↕ | Azione↕ |
|---|---|---|---|
BAD_REQUEST | 400 | Parametri di input o richiesta non validi. | Correggi la richiesta: controlla i campi, i formati e i valori richiesti. |
NOT_FOUND | 404 | Una risorsa referenziata non esiste. | Verificare che gli ID, i codici e che le impostazioni predefinite richieste siano configurate. |
UNAVAILABLE | 503 | Il servizio o l'opzione richiesta non è disponibile per questa tratta. | Prova un metodo, un livello di servizio o una destinazione diversi. |
PERMISSION_DENIED | 401 / 403 | Errore di autenticazione o autorizzazione. | Controlla le credenziali e le autorizzazioni dell'account. |
FAILED_PRECONDITION | 412 | Una condizione di configurazione o impostazione richiesta non è stata soddisfatta. | Controlla le impostazioni dell'organizzazione o contatta l'assistenza. |
INTERNAL | 500 | Si è verificato un errore imprevisto sul lato server. | Riprovare la richiesta; contattare l'assistenza se il problema persiste. |
UNKNOWN | 500 | Un errore imprevisto senza ulteriore classificazione. | Verificare il formato della richiesta; contattare l'assistenza se il problema persiste. |
Errori API
Comprendere e risolvere gli errori restituiti da Zonos GraphQL API.
GraphQL
Zonos API restituisce due tipi di errori: codici di stato HTTP per errori a livello di trasporto ed errori GraphQL per problemi a livello di applicazione. La maggior parte degli errori sono errori GraphQL che includono una classificazione nel campo
extensionsper identificare la causa e la soluzione appropriata.