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. Es gibt standardmäßige 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 - informational responseDie Anfrage wurde empfangen, die Bearbeitung wird fortgesetzt * 2xx - successfulDie Anfrage wurde erfolgreich empfangen, verstanden und akzeptiert * 3xx - redirectionEs müssen weitere Maßnahmen ergriffen werden, um die Anfrage zu vervollständigen * 4xx - client errorDie Anfrage enthält eine fehlerhafte Syntax oder kann nicht erfüllt werden * 5xx - server errorDer Server 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 eine Anwendung so konfiguriert werden kann, dass sie Fehler 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 Connector-Funktion erneut aus, um zu testen, ob die Ausgabe korrekt erscheint.

Dies wird wie das folgende Beispiel aussehen:

Erstellen einer App zur Behandlung von Connector-Fehlern

Verwenden Sie die Informationen der Ausgänge 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 Konnektor 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.

Visualisieren der Connector-Antwort in einer App

Platzieren Sie ein Variablen-Widget auf einem App-Schritt, das die gesamte Variable der Connector-Antwort 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) (Hinweis) Viele Systeme verwenden den Antwortcode 200 als eine gute Antwort, aber es ist am besten, mit dem API-Endpunktanbieter oder der IT-Abteilung zu überprüfen, ob alle guten Antworten nur den Code 200 :: haben werden:
3. Erstellen Sie eine Trigger-Aktion, die ausgelöst wird, wenn die Bedingung erfüllt ist, wenn der HTTP-Antwortcode schlecht 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 Anwendungen