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. Deve essere utilizzato anche per gli errori della logica di business
(ad esempio, viene completato il campo booking_failure in
CreateBookingResponse) |
| 400 | Richiesta non valida | Richiesta errata/argomenti non validi (commerciante, servizio, slot non trovato, tentativo di prenotare una fascia oraria non valida, annullamento di una prenotazione che non è mai esistita). |
| 401 | Non autorizzato | Non autenticata (credenziali non valide, riprova l'accesso). La richiesta non dispone di credenziali di autenticazione valide per l'operazione. |
| 403 | Vietato | Autorizzazione negata/non consentita (il chiamante è noto e rifiutato). Questa risposta non deve essere utilizzata per i rifiuti causati dall'esaurimento di alcune risorse (utilizza Too Many Requests al posto degli errori).
Non utilizzare Forbidden se non è possibile identificare il chiamante (utilizza Unauthorized per questi errori). |
| 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 contemporaneità come un errore di controllo del sequenziatore o l'interruzione della transazione. |
| 429 | Troppe richieste | Alcune risorse sono state esaurite, ad esempio una quota per utente o l'intero file system ha esaurito lo spazio. |
| 499 | Richiesta chiusa dal client | L'operazione è stata annullata, in genere dal chiamante. |
| 500 | Errore interno del server | Errori interni. Ciò significa che alcune invarianti previste dal sistema sottostante sono state interrotte. Questo codice di errore è riservato a errori gravi. |
| 501 | Non implementata | 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 temporanea, che può essere corretta riprovando con un backoff. |
| 504 | Timeout del gateway | Il termine ultimo è scaduto 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 corretta da un server potrebbe essere stata ritardata abbastanza a lungo fino alla scadenza della scadenza. |
A volte possono essere applicati più codici di errore. I servizi dovrebbero restituire il codice di errore più specifico applicabile.