Die folgenden Statuscodes können in HTTP-Antworten zurückgegeben werden.
| HTTP-Code | HTTP-Beschreibung | Hinweise |
|---|---|---|
| 2xx | OK | Kein Fehler; wird bei Erfolg angezeigt Dies sollte auch bei Fehlern der Geschäftslogik verwendet werden (z. B. wenn booking_failure in CreateBookingResponse ausgefüllt ist). |
| 400 | Ungültige Anfrage | Ungültige Anfrage/Ungültige Argumente (Händler, Dienstleistung, Slot nicht gefunden, Buchung eines ungültigen Slots, Stornierung einer Buchung, die es nie gab) |
| 401 | Unauthorized (Nicht autorisiert) | Nicht authentifiziert (ungültige Anmeldedaten, Anmeldeversuch wiederholen). Die Anfrage enthält keine gültigen Authentifizierungsdaten für diesen Vorgang. |
| 403 | Forbidden (Unzulässig) | Berechtigung verweigert/verboten (Aufrufer ist bekannt und wurde abgelehnt). Diese Antwort darf nicht für Ablehnungen verwendet werden, die durch erschöpfte Ressourcen verursacht werden. Verwende stattdessen Too Many Requests für diese Fehler.
Forbidden darf nicht verwendet werden, wenn der Aufrufer nicht ermittelt werden kann (verwenden Sie stattdessen Unauthorized für diese Fehler). |
| 404 | Not Found (Nicht gefunden) | Nicht gefunden (Ressource nicht gefunden, ungültige URL, einschließlich ungültiger RPCs) |
| 409 | Konflikt | Der Vorgang wurde abgebrochen, in der Regel aufgrund eines Parallelitätsproblems wie einer fehlgeschlagenen Sequencer-Überprüfung oder einer abgebrochenen Transaktion. |
| 429 | Zu viele Anfragen | Eine Ressource, z. B. ein nutzerbezogenes Kontingent, ist erschöpft oder der Speicherplatz für das gesamte Dateisystem ist ausgegangen. |
| 499 | Client Closed Request (Anfrage vom Client abgebrochen) | Der Vorgang wurde abgebrochen, in der Regel vom Aufrufer. |
| 500 | Internal Server Error (Interner Serverfehler) | Interne Fehler. Das bedeutet, dass einige Invarianten, die vom zugrunde liegenden System erwartet werden, nicht erfüllt wurden. Dieser Fehlercode ist für schwerwiegende Fehler reserviert. |
| 501 | Nicht implementiert | Dieser Vorgang ist nicht implementiert oder wird bei diesem Dienst nicht unterstützt bzw. ist bei diesem Dienst nicht aktiviert. |
| 503 | Service Unavailable (Dienst nicht verfügbar) | Der Dienst ist derzeit nicht verfügbar. Dies ist höchstwahrscheinlich ein vorübergehender Zustand, der durch Wiederholen mit einem Backoff korrigiert werden kann. |
| 504 | Gateway Timeout (Gateway-Zeitüberschreitung) | Die Frist ist abgelaufen, bevor der Vorgang abgeschlossen werden konnte. Bei Vorgängen, die den Systemstatus verändern, kann dieser Fehler angezeigt werden, auch wenn der Vorgang erfolgreich abgeschlossen wurde. Zum Beispiel könnte eine erfolgreiche Antwort von einem Server so lange verzögert worden sein, dass die Frist abgelaufen ist. |
Manchmal können mehrere Fehlercodes zutreffen. Dienste sollten den spezifischsten Fehlercode liefern, der zutrifft.