HTTP Status Codes

Die API MC verwendet standardmäßige HTTP Statuscodes als Antwort, um den Erfolg oder Misserfolg der Anfrage anzuzeigen. Sofern in der Beschreibung eines Vorgangs nicht anders angegeben, gelten die folgenden allgemeinen Interpretationen der Statuscodewerte.

Tabelle 1 HTTP Status Codes
HTTP Status Code HTTP Statusmeldung Beschreibung
200 OK Die Anfrage war vollständig erfolgreich. Es wird ein Antwortkörper bereitgestellt, der die Ergebnisse der Anfrage enthält.
204 Kein Inhalt Die Anfrage war vollständig erfolgreich, und es werden keine zusätzlichen Antwortinformationen bereitgestellt.
400 Anforderung fehlerhaft In der Anfrage fehlten erforderliche Eingaben, die Eingaben waren fehlerhaft oder enthielten überflüssige Eingaben. Zusätzliche Informationen zum Fehler werden in einem Fehlerantwortkörper bereitgestellt, der einen Grundcode mit zusätzlichen Informationen enthält.
403 Nicht zulässig Mehrere Fehlerbedingungen führen zu diesem Statuscode:
  • Die Anfrage erfordert eine Authentifizierung, aber es wurde kein X-API-Session-Header bereitgestellt, oder es wurde einer bereitgestellt, aber die Session-ID war ungültig.
  • Der Benutzer, unter dem die API-Anforderung authentifiziert wurde, ist nicht berechtigt, den angeforderten Vorgang durchzuführen.
404 Nicht gefunden Mehrere Fehlerbedingungen führen zu diesem Statuscode:
  • Der URI bezeichnet keine existierende Ressource oder eine Ressource, für die der API-Benutzer keine Objektzugriffsberechtigung hat.
  • Der URI bezeichnet eine Ressource oder einen Vorgang, die/der von der MC nicht unterstützt wird, weil sie/er derzeit die alternierende MC ist.
405 Methode nicht zulässig Die Anfrage gibt eine HTTP Methode an, die für den angegebenen URI nicht gültig ist.
409 Konflikt Die verwaltete Ressource befindet sich in einem falschen Zustand (Status) für die Durchführung des angeforderten Vorgangs. Zusätzliche Informationen zum Fehler werden in einem Fehlerantwortkörper bereitgestellt, der einen Grundcode mit zusätzlichen Informationen enthält.
412 Geänderte Ressource Vorbedingung fehlgeschlagen. Wenn der vom Client bereitgestellte ETag und der ETag des Servers übereinstimmen, wird mit POST fortgefahren. Andernfalls führt dies zu dem Fehler 412 resource modified.
413 Anforderungshauptteil zu groß Die Anfrage enthält einen zu großen Anfragetext.
415 Nicht unterstützter Medientyp Der Content-Type-Header für die Anfrage gibt eine Darstellung an, die von der Web Services API nicht unterstützt wird.
500 Interner Serverfehler Bei der Bearbeitung der Anfrage ist ein Serverfehler aufgetreten.
501 Nicht implementiert Die Anfrage gibt eine HTTP Methode an, die vom Server nicht erkannt wird (für keine Ressource).
503 Service nicht verfügbar Das Ersuchen konnte vom MC aufgrund eines vorübergehenden Zustands nicht ausgeführt werden.
505 HTTP-Version nicht unterstützt Die Anfrage gibt eine HTTP Protokollversion an, die von der Web Services API nicht unterstützt wird.