HTTP-Statuscodes

Die MC -API verwendet HTTP-Standardstatuscodes als Antwort, um den Erfolg oder das Fehlschlagen der Anforderung anzuzeigen. Sofern in der Beschreibung einer Operation nicht anders angegeben, gelten die folgenden allgemeinen Interpretationen der Statuscodewerte.

Tabelle 1. HTTP-Statuscodes
HTTP-Statuscode HTTP-Statusnachricht Beschreibung
200 OK Die Anforderung war erfolgreich. Es wird ein Antworthauptteil bereitgestellt, der die Ergebnisse der Anfrage enthält.
204 Kein Inhalt Die Anforderung war erfolgreich und es werden keine weiteren Antwortinformationen bereitgestellt.
400 Ungültige Anforderung In der Anforderung fehlte die erforderliche Eingabe, sie enthielt Fehler in der bereitgestellten Eingabe oder enthielt irrelevante Eingabe. Weitere Informationen zum Fehler werden in einem Fehlerantworthauptteil bereitgestellt, der einen Ursachencode mit zusätzlichen Informationen enthält.
403 Unzulässig Mehrere Fehlerbedingungen führen zu folgendem Statuscode:
  • Die Anforderung erfordert eine Authentifizierung, aber es wurde kein X-API-Session-Header angegeben oder ein Header wurde angegeben, aber die Sitzungs-ID war ungültig.
  • Der Benutzer, unter dem die API-Anforderung authentifiziert wurde, ist nicht berechtigt, die angeforderte Operation auszuführen.
404 Nicht gefunden Mehrere Fehlerbedingungen führen zu folgendem Statuscode:
  • Der URI gibt keine noch vorhanden Ressource an oder gibt eine Ressource an, für die der API-Benutzer keine Objektzugriffsberechtigung hat.
  • Der URI bezeichnet eine Ressource oder Operation, die von der MC nicht unterstützt wird, da sie derzeit die alternative MC ist.
405 Methode nicht zulässig Die Anforderung gibt eine HTTP-Methode an, die für den angegebenen URI nicht gültig ist.
409 Konflikt Die verwaltete Ressource hat einen falschen Status (Status) für die Ausführung der angeforderten Operation. Weitere Informationen zum Fehler werden in einem Fehlerantworthauptteil bereitgestellt, der einen Ursachencode mit zusätzlichen Informationen enthält.
412 Ressource geändert Vorbedingung fehlgeschlagen. Wenn der vom Client bereitgestellte ETag und der Server-ETag übereinstimmen, fahren Sie mit dem POST fort. Andernfalls führt dies zu einem Fehler mit 412 geänderten Ressourcen.
413 Anforderungshauptteil zu groß Die Anforderung enthält einen Anforderungshauptteil, der zu groß ist.
415 Nicht unterstützter Medientyp Der Header 'Content-Type' für die Anforderung gibt eine Darstellung an, die von der Web Services -API nicht unterstützt wird.
500 Interner Serverfehler Während der Verarbeitung der Anforderung ist ein Serverfehler aufgetreten.
501 Nicht implementiert Die Anforderung gibt eine HTTP-Methode an, die vom Server (für alle Ressourcen) nicht erkannt wird.
503 Service nicht verfügbar Die Anforderung konnte vom MC aufgrund einer temporären Bedingung nicht ausgeführt werden.
505 HTTP-Version nicht unterstützt Die Anforderung gibt eine HTTP-Protokollversion an, die von der Web Services -API nicht unterstützt wird.