Abfangen von HTTP-Verbindungsfehlern

Verstehen Sie die Anwendungsfälle, in denen ein HTTP-API-Connector-Fehler auftritt, und erfahren Sie, wie Sie den Fehler protokollieren und die Connector-Funktion erneut versuchen können.

Arten von HTTP-Connector-Fehlern

Der HTTP-Protokollstandard schreibt einen Server-Antwortcode und eine Nachricht vor, die als HTTP-Antwortcode und HTTP-Antwortnachricht bezeichnet werden, und enthält Standard-HTTP-Antwortcodeklassen oder -kategorien, die den Endbenutzern helfen, die Art des aufgetretenen Fehlers intuitiv zu erkennen.Zu diesen Code-Klassen gehören die folgenden:* 1xx - informative AntwortDieAnfrage wurde empfangen und wird weiter bearbeitet* 2xx - erfolgreichDieAnfrage wurde erfolgreich empfangen, verstanden und akzeptiert* 3xx - UmleitungWeitereMaßnahmen müssen ergriffen werden, um die Anfrage zu vervollständigen* 4xx - Client-FehlerDieAnfrage enthält eine fehlerhafte Syntax oder kann nicht erfüllt werden* 5xx - Server-FehlerDerServer konnte eine offensichtlich gültige Anfrage nicht erfüllen

Der am häufigsten auftretende Fehlercode ist 404 - Not Found oder 500 - Internal Server Error. Diese Fehlercodes können darauf hinweisen, dass der Server des externen Systems ausgefallen ist, dass Wartungsarbeiten durchgeführt werden, dass es ein Problem mit dem Dienst gibt oder dass ein Netzwerkproblem vorliegt.

Beispiel: Abfangen von HTTP-Fehlern in einer App

Das folgende Beispiel zeigt, wie Sie eine Anwendung so konfigurieren, dass sie Fehler in der HTTP-Connector-Funktion anzeigt.

Erstellen Sie die Connector-Funktion

Im Connector Function Builder können Sie den HTTP-Fehlercode und die Fehlermeldung in der Konfiguration des Connectors Output zuordnen. Dadurch werden der HTTP-Fehlercode und die Fehlermeldung als Ausgaben der Konnektorfunktion übergeben, die später in Tulip Apps verwendet werden können.

1. Ordnen Sie die HTTP-Statusfelder den Ausgängen zu.
2. Geben Sie den Ausgaben einen klaren, eindeutigen Namen und führen Sie die Konnektorfunktion erneut aus, um zu testen, ob die Ausgabe korrekt erscheint.

Dies sieht dann wie das folgende Beispiel aus:

Erstellen einer App zur Behandlung von Konnektor-Fehlern

Verwenden Sie die Informationen über die Ausgaben des Konnektors in Anwendungen, um die Fehlerbehandlung des Konnektors durchzuführen.

Ausführen des Konnektors in einem App-Trigger

Erstellen Sie eine Trigger-Aktion mit Run Connector Function. Wählen Sie den Connector und die Funktion, die Sie gerade erstellt haben, und speichern Sie das Ergebnis als Variable.

Der HTTP Response Code und die Nachricht sind nun als Referenz in der neuen App-Variable verfügbar.

Visualisierung der Connector Response in einer App

Platzieren Sie ein Variablen-Widget auf einem App-Schritt, das die gesamte Connector Response-Variable anzeigt.

Connector-Fehlerbehandlungs-Trigger erstellen

Als Nächstes können Sie den HTTP-Antwortcode verwenden, um eine Fehlerbehandlung auf App-Ebene in einer nachfolgenden Trigger-Bedingung durchzuführen.

1. Erstellen Sie einen neuen Trigger, um die Connector-Fehlerbehandlung durchzuführen.
2. Erstellen Sie eine Bedingung, die nach dem HTTP-Antwortcode sucht, der nicht korrekt ist. In diesem Beispiel sucht die Bedingung nach Antworten, die nicht gleich 200 sind.:::(Info) (Note)
   Many systems use a 200 response code as a good response, but it is best to check with the API endpoint provider or IT if all good responses will only be of code 200
   :::
3. Erstellen Sie eine auslösende Aktion, die eintritt, wenn die Bedingung erfüllt ist, wenn der HTTP-Antwortcode fehlerhaft ist.

So sieht das in der Anwendung aus:

Weitere Lektüre

• Wie man eine HTTP-Connector-Funktion erstellt und konfiguriert
• Wie man HTTP-Connector-Ausgaben formatiert
• Verwendung von HTTP-Konnektoren in Apps