Fehler und Fehlerbehebung
Verwenden Sie den HTTP-Status und den Fehlercode, um die Ursache zu verstehen und das weitere Vorgehen zu bestimmen.
Fehlerantwort lesen#
Connect API-Fehler enthalten einen stabilen code, eine lesbare message und eine request_id zur Untersuchung.
{
"code": "token_expired",
"message": "Token has expired.",
"request_id": "example-request-id"
}Häufige Statuscodes#
| Status | Was zu prüfen ist |
|---|---|
400 Ungültige Anfrage | Prüfen Sie Pflichtparameter, Zeitstempelformat, Zeitraum, Sensorkennungen und Paginierung. Ermitteln Sie die ungültige Eingabe anhand des Fehlercodes. |
401 Nicht autorisiert | missing_token: Ergänzen Sie den Bearer-Header. invalid_token: Prüfen Sie Token und Umgebung. token_expired oder token_revoked: Erstellen Sie ein neues Token in IRIS Cloud. |
404 Nicht gefunden | Prüfen Sie die Ressourcen-ID und ob die Ressource zur Organisation des Tokens gehört. Einige Anfragen erfordern außerdem eine verfügbare Maschinenkonfiguration. |
501 Nicht implementiert | Die Integration der Aktionsprotokolle ist noch nicht verfügbar. |
502 / 503 / 504 | Ein benötigter Dienst ist fehlgeschlagen, nicht verfügbar oder hat das Zeitlimit überschritten. Wiederholen Sie die Anfrage bei vorübergehenden Fehlern mit zunehmenden Wartezeiten und begrenzter Anzahl von Versuchen. Bewahren Sie bei anhaltenden Problemen die Anfrage-ID auf. |
Die Referenz jedes Endpunkts enthält die genauen Antworten und Fehlerbeispiele.
Wenn Swagger die API nicht erreicht#
Wenn Swagger Failed to fetch ohne HTTP-Antwort meldet, prüfen Sie API-Adresse, Netzwerkverbindung und mögliche VPN-Anforderungen. Browseranfragen erfordern außerdem, dass die API den Ursprung der Dokumentationswebsite über CORS zulässt.
Testen Sie die entsprechende cURL-Anfrage. Funktioniert cURL, aber nicht der Browser, teilen Sie diesen Unterschied Ihrem Administrator mit. Ein Verbindungsfehler im Browser bedeutet nicht zwangsläufig, dass das Token ungültig ist.
Die richtigen Angaben bei Supportanfragen#
Wenden Sie sich an Ihren üblichen IRIS Cloud-Supportkontakt oder den Organisationsadministrator. Geben Sie Umgebung, Endpunkt, HTTP-Status, Fehlercode, Anfrage-ID und Zeitpunkt der Anfrage an. Entfernen Sie Tokens und vertrauliche Antwortdaten aus allen weitergegebenen Informationen.