HTTP-Statuscodes

Die folgenden Statuscodes können in HTTP-Antworten zurückgegeben werden.

HTTP-Code HTTP-Beschreibung Hinweise
2xx OK Kein Fehler; wird bei Erfolg angezeigt Sollte auch bei Fehlern in der Geschäftslogik verwendet werden (z.B. ist booking_failure in CreateBookingResponse ausgefüllt)
400 Ungültige Anfrage Fehlerhafte Anfrage/Ungültige Argumente (Händler, Dienstleistung, Slot nicht gefunden, versucht, einen ungültigen Slot zu buchen, Buchung wird abgebrochen, die nie existiert hat).
401 Unauthorized (Nicht autorisiert) Nicht authentifiziert (ungültige Anmeldedaten, Anmeldeversuch wiederholen). Die Anfrage enthält keine gültigen Authentifizierungsdaten für den 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öpfung einer Ressource verursacht werden. Verwenden Sie für diese Fehler stattdessen Too Many Requests. Forbidden darf nicht verwendet werden, wenn der Aufrufer nicht identifiziert werden kann. Verwenden Sie für diese Fehler stattdessen Unauthorized.
404 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 Nebenläufigkeitsproblems wie einer fehlgeschlagenen Sequenzprüfung oder einer abgebrochenen Transaktion.
429 Conflict (Zu viele Anfragen) Eine Ressource, z. B. ein Kontingent pro Nutzer, ist erschöpft oder das gesamte Dateisystem hat nicht mehr genügend Speicherplatz.
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 mehr funktionieren. Dieser Fehlercode ist schwerwiegenden Fehlern vorbehalten.
501 Nicht implementiert Der 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 Wiederholungsversuche mit einem Backoff behoben werden kann.
504 Gateway Timeout (Gateway-Zeitüberschreitung) Die Frist ist abgelaufen, bevor der Vorgang abgeschlossen werden konnte. Bei Vorgängen, die den Systemstatus ändern, kann dieser Fehler zurückgegeben werden, auch wenn der Vorgang erfolgreich abgeschlossen wurde. Beispielsweise kann 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 zurückgeben.