Nelle risposte HTTP possono essere restituiti i seguenti codici di stato.
Codice HTTP | Descrizione HTTP | Note |
---|---|---|
2xx | OK | Non è un errore, ma è stato restituito al meglio. Deve essere utilizzato anche per errori di logica di business (ad esempio, booking_failure in CreateBookingResponse è completato) |
400 | Richiesta non valida | Richiesta errata/argomenti non validi (commerciante, servizio, slot non trovato, tentativo di prenotazione di uno slot non valido, annullamento di una prenotazione che non è mai esistita). |
401 | Non autorizzato | Non autenticati (credenziali non valide, riprova ad accedere). La richiesta non ha credenziali di autenticazione valide per l'operazione. |
403 | Vietato | Autorizzazione negata/vietata (il chiamante è noto e rifiutato). Questa
risposta non deve essere utilizzata per i rifiuti causati dall'esaurimento di alcune
risorse (utilizza invece Too Many Requests per tali errori).
Forbidden non deve essere utilizzato se il chiamante non può essere
identificato (utilizza invece Unauthorized per questi errori). |
404 | Non trovato | Non trovato (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 controllo di sequenza non riuscito o un'interruzione della transazione. |
429 | Troppe richieste | Una risorsa è stata esaurita, forse una quota per utente o forse 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 varianti previste dal sistema sottostante sono state interrotte. Questo codice di errore è riservato agli errori gravi. |
501 | Non implementato | L'operazione non è implementata o non è supportata/attivata 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 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 riuscita da parte di un server potrebbe aver subito un ritardo sufficiente alla scadenza. |
A volte potrebbero essere presenti più codici di errore. I servizi devono restituire il codice di errore più specifico applicabile.