Nach dem Empfang einer Anforderung an die vorgesehene API gibt Cloud App Security eine Antwort zurück, die anzeigt, ob die Anforderung erfolgreich war.
Die Antwort liegt im JSON-Format vor und unterliegt den Statuscodes der HTTP-Antwort.
In der folgenden Tabelle werden die unterstützten HTTP-Antwortstatuscodes beschrieben:
|
Antwortstatus |
Statuscode |
Beschreibung |
|---|---|---|
|
OK |
200 |
Die Anforderung wurde erfolgreich ausgeführt, oder es wurde mindestens ein Datensatz gefunden, der mit den Kriterien in der Anforderung übereinstimmt und im Antworttext zurückgegeben wurde. Im Falle eines JSON-Formats wird die Struktur immer zurückgegeben, auch wenn sie leer ist. |
|
Erstellt |
201 |
Die Anfrage wurde bearbeitet, und die Aktion wurde erfolgreich erstellt. |
|
Ungültige Anforderung |
400 |
Bei der Anforderung fehlt ein erforderlicher Parameter, oder ein Parameter enthält Daten, die falsch formatiert sind. |
|
Nicht autorisiert |
401 |
In der Anforderung sind keine Autorisierungsinformationen enthalten, die Autorisierungsinformationen sind falsch oder der Benutzer ist nicht autorisiert. |
|
Verboten |
403 |
Für die Anforderung ist keine Berechtigung vorhanden. |
|
Nicht gefunden |
404 |
Die angeforderte API oder das angeforderte Aufgaben-Token konnte nicht gefunden werden. |
|
Methode nicht zulässig |
405 |
Die angeforderte Methode wird für die angeforderte API nicht unterstützt. |
|
Zu viele Anforderungen |
429 |
Der Benutzer hat mehr als 20 Anforderungen in der letzten 1 Minute durchgeführt und wurde gedrosselt. Der Benutzer kann neue Anforderungen in der nächsten Minute von der ersten Anforderung starten. |
|
Interner Serverfehler |
500 |
Der Dienst hat eine unerwartete Situation entdeckt und kann die Anforderung nicht besser beantworten. |
|
Service nicht verfügbar |
503 |
Der Server kann die Anforderung nicht bearbeiten (weil er überlastet ist oder wegen Wartungsarbeiten ausgefallen ist). Im Allgemeinen handelt es sich um einen temporären Status. |
Bei einem anderen Statuscode als 200 verfügt jede Fehlerantwort über einen formatierten Text, der aus einem Ergebniscode, einer Ablaufverfolgungs-ID und einer Meldung wie folgt besteht:
HTTP/1.1 <status code> <response status>
Content-Type: application/json
{
"code":(an integer indicating the result of this API call),
"traceId":"(randomly generated identity to uniquely trace the request)",
"msg":"(a string describing the result code)"
}
Eine vollständige Liste der code-Werte finden Sie unter API-Ergebniscodes.