MENU
    HTTPコネクタのエラーをキャッチする
    • 08 Jan 2025
    • 1 読む分
    • 寄稿者

    HTTPコネクタのエラーをキャッチする


    記事の要約

    HTTP API コネクタエラーを検出する使用例と、エラーを記録してコネクタ機能を再試行する方法を理解してください。

    HTTP コネクタエラーの種類

    HTTP プロトコル標準には、HTTP レスポンスコードおよびHTTP レスポンスメッセージとして知られる、サーバレスポンスコードおよびメッセージの要件が含まれています。これにより、エンドユーザが発生したエラーの種類を直感的に示すことができるように、標準的な HTTP レスポンスコードクラスまたはカテゴリがあります。これらのコード・クラスには、次のようなものがあります。*1xx-informational responseリクエストを受信しました、処理を続行します*2xx-successfulリクエストを正常に受信し、理解し、受け付けました*3xx-redirectionリクエストを完了するには、さらにアクションを実行する必要があります*4xx-client errorリクエストに不正な構文が含まれているか、実行できません*5xx-server error明らかに有効なリクエストを実行できませんでした

    最も一般的なエラーコードは、404 - Not Foundまたは500 - Internal Server Errorです。これらのエラーコードは、外部システムのサーバーがダウンしている、メンテナンス中である、サービスに問題がある、またはネットワークに問題があることを示しています。

    例アプリでHTTPエラーをキャッチする

    次の例では、HTTP コネクタ関数のエラーを表示するようにアプリを構成する方法を詳しく説明します。

    コネクタ関数の構築

    Connector Functionビルダでは、コネクタOutput設定でHTTPエラーコードとエラーメッセージをマッピングできます。これにより、HTTPエラーコードとエラーメッセージが、後でTulip Appsで使用するコネクタ関数の出力として渡されます。

    1. Connector Output Mapping 1.png{height="" width=""} HTTPステータスフィールドを出力にマッピングします。
    2. 出力に明確な名前を付け、コネクタ関数を再実行して、出力が正しく表示されるかどうかをテストします。Connector Output Mapping 2.png{height="" width=""} 以下の例のようになります。

    これは次の例のようになります:Catch Connector Errors Overview.gif{height="" width=""}.

    コネクタのエラーを処理するアプリを構築する

    アプリでコネクタの出力情報を使用して、コネクタのエラー処理を実行します。

    アプリのトリガーでコネクタを実行する

    Run Connector Function でトリガアクションを構築します。先ほど構築したコネクタと関数を選択し、結果を変数として保存します。Run Connector Trigger - Error Catching.png{height="" width=""}.

    HTTP レスポンス コードとメッセージが、新しいアプリ変数の参照として利用できるようになりました。HTTP Response Code as Variable.png{height="" width=""}.

    アプリでのコネクタ応答の可視化

    Connector Response変数全体を表示する Variable ウィジェットをアプリのステップに配置します。Visualize connector response with variable widget.gif{height="" width=""}.

    Connector エラー処理トリガの構築

    次に、HTTP 応答コードを使用して、後続のトリガ条件でアプリ レベルのエラー処理を実行できます。

    1. Connector Error Handling Trigger.png{height="" width=""}コネクタ エラー処理を実行する新しいトリガを作成する。
    2. 不正な HTTP 応答コードを検索する条件を作成します。この例では、条件は 200に等しくない応答を探します:(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. Bad Response Code Trigger.png{height="" width=""} 条件が満たされたときに発生するトリガーアクションを作成します。

    アプリでは次のようになります:HTTP Error Response Overview.gif{height="" width=""}.

    さらに読む


    この記事は役に立ちましたか?