HTTP-Statuscodes

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X.
info

Fehlermeldungen in API-Antworten von Edge enthalten einen HTTP-Statuscode und eine Fehlermeldung.

Wenn Sie beispielsweise versuchen, eine Cache-Entität mit demselben Namen wie ein vorhandener Cache zu erstellen, sieht die Antwort so aus:

HTTP/1.1 409 Conflict
{
"code": "messaging.config.beans.CacheAlreadyExists", "message": "Cache duplicate_cache already exists in environment test", "contexts": [] }

In der folgenden Tabelle sind die häufigsten HTTP-Statuscodes und ihre Bedeutung in Apigee Edge zusammengefasst.

HTTP-Statuscode Beschreibung
2xx Vorgang erfolgreich Der API-Aufruf war erfolgreich. HTTP 204 gibt an, dass die Antwort ohne Inhalt gesendet wurde, in der Regel, weil ein DELETE-Vorgang erfolgreich war.
401 Nicht autorisiert. Die Anmeldedaten, die Sie für eine Anfrage verwenden, haben nicht die entsprechenden Berechtigungen zum Ausführen des Vorgangs. Überprüfen Sie die Rollen für das Konto, das Sie verwenden.
403 Verboten. Die Kombination aus Nutzername und Passwort, die Sie verwenden, ist für die angegebene Organisation nicht gültig. Melden Sie sich unter login.apigee.com/login an, um Ihre Anmeldedaten zu testen. Wenn Sie ein Konto benötigen, registrieren Sie sich.

Achten Sie darauf, dass Sie die richtigen Anmeldedaten für Ihre Organisation verwenden, und überprüfen Sie die Rechtschreibung.

404 Keine Suchergebnisse. Prüfen Sie, ob die Anfrage-URL richtig geschrieben ist und ob die API, auf die Sie zugreifen möchten, vorhanden ist. Achten Sie beispielsweise darauf, dass Sie nicht versuchen, auf die falsche Version einer API zuzugreifen. Siehe auch 404 – Proxy für Host <virtual host name> und URL <path> kann nicht identifiziert werden.
405 Methode nicht zulässig. Sie haben eine Methode angegeben, die nicht unterstützt wird. Beispielsweise haben Sie das Verb GET für einen API-Aufruf verwendet, der das Verb POST erfordert.
409 Konflikt. Gibt einen Konflikt mit einer vorhandenen Entität an. Sie haben beispielsweise versucht, einen Cache mit einem Namen zu erstellen, der bereits vorhanden ist.
415 Nicht unterstützter Medientyp. Dieser Fehler tritt in der Regel bei POST- oder PUT Anfragen auf, wenn der Content-type HTTP-Header auf den falschen Wert festgelegt ist. Beispiel: Wenn Sie Folgendes an eine API senden, die nur JSON unterstützt, wird ein HTTP-415-Fehler zurückgegeben:
$ curl https://api.company.com/v1/json_service
  -X POST
  -H "Content-type:text/xml"
  -d '<SomeXML>'

Verwenden Sie für GET-Anfragen den Accept Header anstelle des Content-type Headers.

429 Zu viele Anfragen. Die Ratenbegrenzung wurde für Kontingent- oder Spike Arrest-Richtlinien überschritten. Der aktuelle Standardstatuscode für das Überschreiten der Ratenbegrenzung ist 500, aber der Standard kann sich in Zukunft auf 429 ändern. Informationen zum Ändern des Statuscodes 500 in 429 finden Sie unter Spike Arrest-Richtlinie und Kontingentrichtlinie.
500 Siehe 500 – Interner Serverfehler.
502 Siehe 502 – Fehlerhaftes Gateway.
503 Siehe 503 – Dienst nicht verfügbar.
504 Siehe 504 – Gateway-Zeitüberschreitung.