Alle Antworten enthalten einen HTTP-Statuscode und, es sei denn, der Statuscode lautet 204 (kein Inhalt), eine Accept-Kopfzeile. Der Inhalt der Antwort hängt von der Anforderung ab. Manche Antworten enthalten einen Dokumententext, manche nur eine URL, und manche sind leer.

HTTP-Antwortcodes

Ein API-Client kann in einer Antwort eine Teilmenge von HTTP-Statuscodes erwarten.

Tabelle 1. Von der API ausgegebene HTTP-Statuscodes
Statuscode Statusbeschreibung
200 OK Die Anforderung ist gültig und wurde fertiggestellt. Die Antwort umfasst einen Dokumententext.
201 Created Die Anforderung ist gültig. Das angeforderte Objekt wurde erzeugt und ist unter der in der Location-Kopfzeile angegebenen URL zu finden.
202 Accepted Die Anforderung ist gültig, und es wurde eine Aufgabe erstellt, um Sie zu bearbeiten. Diese Antwort wird in der Regel von einem TaskStatus-Element begleitet.
204 No Content Die Anforderung ist gültig und wurde abgeschlossen. Die Antwort enthält keinen Text.
400 Bad Request Der Anforderungstext ist fehlerhaft, unvollständig oder aus anderen Gründen ungültig.
401 Unauthorized Die Anmeldung ist fehlgeschlagen, oder die Gültigkeit des Authentifizierungs-Token ist abgelaufen.
403 Forbidden Der Benutzer ist nicht authentifiziert oder hat keine ausreichende Berechtigung für den Zugriff auf ein oder mehrere in der Anforderung angegebene Objekte.
404 Not Found Das in der Anforderung angegebene Objekt wurde nicht gefunden.
405 Method Not Allowed Die in der Anforderung angegebene HTTP-Methode wird für dieses Objekt nicht unterstützt.
406 Not Acceptable Die durch die Anforderung benannte Ressource kann keine Antwort von dem in der Accept-Kopfzeile der Anforderung angegebenen Typ generieren.
415 Unsupported Media Type Die durch die Anforderung benannte Ressource unterstützt keine Anforderung mit dem angegebenen Content-Type und der angegebenen HTTP-Methode.
422 Not Found Zeigt in der Regel an, dass die URL oder der Text der Anforderung fehlerhaft ist.
429 Too Many Requests Ein Client hat zu viele Anforderungen gesendet, oder mehrere Clients senden zu viele gleichzeitige Anforderungen, die der Server aufgrund von Geschwindigkeitsbeschränkungen nicht verarbeiten kann.

Um das Problem zu umgehen, versuchen Sie später, die Anforderung noch einmal senden.

500 Internal Server Error Die Anforderung ist eingegangen, konnte aber wegen eines internen Serverfehlers nicht abgeschlossen werden.
503 Service Unavailable Der Server kann die Anforderung derzeit wegen einer temporären Bedingung nicht bearbeiten, z. B. weil die Ressourcen ausgeschöpft sind oder der Server gewartet wird.
504 Gateway Timeout Der Server hat in seiner Funktion als Gateway bzw. Proxy keine rechtzeitige Antwort von dem durch die Anforderungs-URL angegebenen vorgelagerten Server erhalten.