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 für Fehler in der Geschäftslogik verwendet werden (z. B. wird booking_failure in CreateBookingResponse ausgefüllt). |
400 | Ungültige Anfrage | Ungültige Anfrage/Ungültige Argumente (Händler, Dienst, Slot wurde nicht gefunden, Buchung eines ungültigen Slots, Stornierung einer Buchung, die es nie gegeben hat). |
401 | Unauthorized (Nicht autorisiert) | Nicht authentifiziert (ungültige Anmeldedaten, Anmeldeversuch wiederholen). Die Anfrage enthält keine gültigen Anmeldedaten für die Authentifizierung des Vorgangs. |
403 | Forbidden (Unzulässig) | Berechtigung verweigert/verboten (Aufrufer ist bekannt und wurde abgelehnt). Diese Antwort darf nicht für Ablehnungen verwendet werden, die dadurch verursacht werden, dass eine Ressource ausgeschöpft ist. Verwende stattdessen Too Many Requests für diese Fehler.
Forbidden darf nicht verwendet werden, wenn der Aufrufer nicht identifiziert werden kann. Verwende stattdessen Unauthorized für diese Fehler. |
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 Problems mit der Nebenläufigkeit, z. B. aufgrund einer fehlgeschlagenen Sequenzerprüfung oder einer abgebrochenen Transaktion. |
429 | Conflict (Zu viele Anfragen) | Eine Ressource ist aufgebraucht, z. B. ein Kontingent pro Nutzer, oder es ist kein Speicherplatz mehr im gesamten Dateisystem verfügbar. |
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 Varianten, die vom zugrunde liegenden System erwartet wurden, nicht mehr funktionieren. Dieser Fehlercode ist für schwerwiegende Fehler reserviert. |
501 | Not Implemented (Nicht implementiert) | Der Vorgang ist nicht implementiert oder wird in diesem Dienst nicht unterstützt/aktiviert. |
503 | Service Unavailable (Dienst nicht verfügbar) | Der Dienst ist derzeit nicht verfügbar. Dies ist höchstwahrscheinlich eine vorübergehende Bedingung, die durch einen erneuten Versuch 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 ändern, kann dieser Fehler zurückgegeben werden, auch wenn der Vorgang erfolgreich abgeschlossen wurde. Zum Beispiel könnte eine erfolgreiche Antwort von einem Server so lange verzögert werden, bis die Frist abgelaufen ist. |
Manchmal können mehrere Fehlercodes zutreffen. Dienste sollten den spezifischsten Fehlercode zurückgeben, der zutrifft.