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ステータスフィールドを出力にマッピングします。
2. 出力に明確な名前を付け、コネクタ関数を再実行して出力が正しく表示されるかテストします。

これは次の例のようになります：

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

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

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

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

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

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

Connector Response変数全体を表示する Variable ウィジェットをアプリのステップに配置します。

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

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

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

アプリではこのようになります：

さらに読む

• HTTP コネクタ関数の作成と設定方法
• HTTPコネクタ出力のフォーマット方法
• アプリでのHTTPコネクタの使用