MENU
    HTTPコネクタのエラーをキャッチする
    • 24 Jun 2024
    • 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. HTTPステータスフィールドを出力にマッピングします。Connector Output Mapping 1.png
    2. 出力に明確な名前を付け、コネクタ関数を再実行して出力が正しく表示されるかテストします。Connector Output Mapping 2.png

    これは次の例のようになります:Catch Connector Errors Overview.gif

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

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

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

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

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

    アプリでコネクタ応答を可視化する

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

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

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

    1. Connector Error Handling を実行する新しいトリガを作成します。Connector Error Handling Trigger.png
    2. 不正な HTTP 応答コードを検索する条件を作成します。この例では、条件は 200 に等しくない応答を探します。:::(Info) (注)多くのシステムは 200 応答コードを良い応答として使用しますが、良い応答がすべてコード 200 :: だけであるかどうかは、API エンドポイントプロバイダまたは IT に確認するのが最善です:
    3. HTTPレスポンスコードが悪いという条件が満たされたときに発生するトリガーアクションを作成する。Bad Response Code Trigger.png

    アプリではこのようになります:HTTP Error Response Overview.gif

    さらに読む


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