I seguenti codici di stato possono essere restituiti nelle risposte HTTP.
| Codice HTTP | Descrizione HTTP | Note |
|---|---|---|
| 2xx | OK | Non è un errore; viene restituito in caso di esito positivo. Questo valore deve essere utilizzato anche per gli errori di logica di business
(ad es. booking_failure in
CreateBookingResponse
è compilato) |
| 400 | Richiesta errata | Richiesta non valida/Argomenti non validi (attività commerciale, servizio, spazio non trovato, tentativo di prenotare uno spazio non valido, annullamento di una prenotazione che non è mai stata effettuata). |
| 401 | Non autorizzato | Non autenticato (credenziali non valide, riprova ad accedere). La richiesta non ha credenziali di autenticazione valide per l'operazione. |
| 403 | Vietato | Autorizzazione negata/vietata (chiamare è noto e rifiutato). Questa risposta
non deve essere utilizzata per i rifiuti causati dall'esaurimento di alcune
risorse (per questi errori, utilizza Too Many Requests).
Forbidden non deve essere utilizzato se non è possibile identificare il chiamante (per questi errori, utilizza Unauthorized). |
| 404 | Non trovato | Non trovata (risorsa non trovata, URL non valido, incluse RPC non valide) |
| 409 | Conflitto | L'operazione è stata interrotta, in genere a causa di un problema di concorrenza, ad esempio un errore di controllo del sequenziatore o l'interruzione della transazione. |
| 429 | Troppe richieste | È stata esaurita una risorsa, ad esempio una quota per utente, oppure l'intero file system non dispone di spazio. |
| 499 | Richiesta chiusa dal cliente | L'operazione è stata annullata, in genere dal chiamante. |
| 500 | Errore interno del server | Errori interni. Ciò significa che alcune invarianti previste dal sistema di base sono state violate. Questo codice di errore è riservato per errori gravi. |
| 501 | Non implementato | L'operazione non è implementata o non è supportata/abilitata in questo servizio. |
| 503 | Servizio non disponibile | Il servizio non è al momento disponibile. Molto probabilmente si tratta di una condizione transitoria, che può essere corretta riprovando con un backoff. |
| 504 | Timeout del gateway | La scadenza è scaduta prima del completamento dell'operazione. Per le operazioni che modificano lo stato del sistema, questo errore può essere restituito anche se l'operazione è stata completata correttamente. Ad esempio, una risposta positiva da un server potrebbe aver subito un ritardo sufficientemente lungo da far scadere la scadenza. |
A volte possono essere applicati più codici di errore. I servizi devono restituire il codice di errore più specifico applicabile.