HTTPエラー処理 ​

HTTPコネクターは、リクエストが失敗したときに問題を特定、管理、解決するのに役立つ充実したエラーデータを提示します。 HTTPステータス、標準化されたエラーメッセージ、およびヘッダーや本文などの構造化されたレスポンス詳細を表示します。 これらの詳細により、明確性が向上し、自動化がサポートされます。 この機能は現在、HTTPコネクターに適用されます。

エラーメッセージの表示方法 ​

Send requestアクションが非2xxレスポンスを受信すると、コネクターはエラーを発生させます。

ジョブレポートのErrorタブには、以下が表示されます:

• 構造化されたエラーメッセージ
• HTTPレスポンスステータス
• レスポンスヘッダー
• レスポンス本文（該当する場合）

各値は専用フィールドに表示されます。 これらは、Monitorブロック、ログ、またはその他のエラー処理ロジックで使用できます。

MonitorおよびOn errorブロック用のHTTPコネクターエラーデータピル。

エラー構造 ​

HTTPコネクターは、ジョブエラーに以下のフィールドを含めます:

HTTPエラーカテゴリー ​

HTTPコネクターは、非2xxレスポンスに対してエラーを発生させます。 これには、3xx HTTPリダイレクトエラー、4xxクライアントエラー、および5xxサーバーエラーが含まれます。

コネクターによって返されるHTTPエラーは、HTTPステータスコードクラスに基づく構造化されたerror_type_idパターンに従います。 HTTPエラータイプIDのこの構造化カタログは、現在HTTPコネクターでのみサポートされています。

MonitorまたはOn errorブロックでerror_type_idプレフィックスを使用して、関連するHTTP失敗をグループ化できます。

Retry succeeds列は、レシピがパラメーターを変更せずに同じリクエストを再試行した場合に成功する可能性があるかどうかを示します。 これは、このセクションの以下の表に適用されます。

HTTPリダイレクトエラータイプID ​

HTTPコネクターは、HTTP 3xxレスポンスに対して以下のerror_type_id値を返します:

HTTPクライアントエラータイプID ​

HTTPコネクターは、HTTP 4xxレスポンスに対して以下のerror_type_id値を返します:

HTTPサーバーエラータイプID ​

HTTPコネクターは、HTTP 5xxレスポンスに対して以下のerror_type_id値を返します:

エラーとして扱われる成功HTTPレスポンスコード ​

HTTPコネクターは、下位互換性のために、特定の成功HTTPレスポンスをエラーとして扱う場合があります。

これらのレスポンスは成功HTTPステータスコードを使用しますが、HTTPコネクターではエラーとして表示される場合があります。

サポートされていないRFC HTTPレスポンスコード ​

HTTPコネクターは、サポートされているRFC定義のレスポンスコードにマッピングされないHTTPステータスコードを受信すると、フォールバックerror_type_id値を返す場合があります。 これらの識別子は、サポートされていない、または非標準のHTTPレスポンスコードを表します:

構造化されたHTTPエラー出力 ​

HTTPコネクターは、デバッグ、フィルタリング、自動化に使用できる構造化されたエラーオブジェクトを返します。 このオブジェクトには、HTTPステータスコード、レスポンス本文、ヘッダー、機械可読なエラータイプIDなどのフィールドが含まれます。 例:

{
  "error_type_id": "err.http.response.client_error.not_found",
  "error_type": "Not Found",
  "error_id": "ad6a...b3c",
  "error_message": "HTTP 404 error",
  "http_response": {
    "code": 404,
    "status_text": "Not Found",
    "body": "{\"error\": \"Resource not found\"}",
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

この構造化されたエラーデータには、以下からアクセスできます:

• ジョブレポート
• Monitorブロック（エラーデータピル）
• On errorブロック（エラーデータピル）

Workatoでは、自動化にerror_type_idを使用することを推奨しています。 このフィールドは安定しており、信頼性の高いプログラムによるチェックをサポートします。

エラー処理のベストプラクティス ​

信頼性の高いレシピを構築するには、MonitorまたはOn errorブロックでerror_type_idおよびhttp_responseフィールドを使用します:

• error_type_idを使用して特定のエラーをキャッチして処理
• HTTPステータスコードまたはレスポンスヘッダーに基づいてリクエストを再試行
• 構造化されたエラーデータをログまたはアラートシステムに送信

これらのフィールドにより、文字列解析や壊れやすいパターンマッチングが不要になります。