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.