Codici di risposta di stato

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.