MENU
    Abfangen von HTTP-Verbindungsfehlern
    • 08 Jan 2025
    • 2 Minuten zu lesen
    • Mitwirkende

    Abfangen von HTTP-Verbindungsfehlern


    Artikel-Zusammenfassung

    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.Connector Output Mapping 1.png
    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.Connector Output Mapping 2.png

    Dies sieht dann wie das folgende Beispiel aus:Catch Connector Errors Overview.gif

    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.Run Connector Trigger - Error Catching.png

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

    Visualisierung der Connector Response in einer App

    Platzieren Sie ein Variablen-Widget auf einem App-Schritt, das die gesamte Connector Response-Variable anzeigt.Visualize connector response with variable widget.gif

    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.Connector Error Handling Trigger.png
    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.Bad Response Code Trigger.png

    So sieht das in der Anwendung aus:HTTP Error Response Overview.gif

    Weitere Lektüre


    War dieser Artikel hilfreich?