HTTP connector - HTTP経由でリクエストを送信アクション ​

ガイド付きセットアップを開始をクリックしてHTTPウィザードを開きます。

呼び出す予定のAPIエンドポイントのHTTPメソッドを選択するには、メソッドドロップダウンメニューを使用します。 この例ではGETを使用します。

HTTPメソッドとリクエストURLを指定

リクエストURLフィールドにAPIエンドポイントの絶対URLを入力します。

または、コネクション設定でベースURLを設定している場合は、このフィールドに相対URLを入力します。 たとえば、ベースURLがhttps://api.example.com/で絶対URLがhttps://api.example.com/users/123の場合、相対URLはusers/123です。

この例では、ServiceNowの既存のインシデントレコードを表示する予定です。 ServiceNowドキュメントによると、これは次のエンドポイントを使用するGET呼び出しです:

https://<instance>.service-now.com/api/now/v1/table/incident

URL内の<instance>を、使用しているServiceNowインスタンスの特定の名前に置き換えます。

HTTPメソッドとリクエストURLの設定

次へをクリックします。

手動で設定をクリックします。

リクエストセクションに移動し、メソッドドロップダウンメニューを使用して、マルチパートフォームリクエストをサポートする次のいずれかのメソッドを選択します:

• POST
• PUT
• PATCH
• DELETE

リクエストURLフィールドにAPIエンドポイントの絶対URLを入力します。 または、コネクション設定でベースURLを設定している場合は、相対URLを入力します。 たとえば、ベースURLがhttps://api.example.com/で絶対URLがhttps://api.example.com/users/123の場合、相対URLはusers/123です。

リクエストコンテンツタイプドロップダウンメニューを使用して、Multipart formを選択します。

リクエストボディスキーマフィールドに移動し、フィールドを手動で追加をクリックして新しいフィールドを追加ダイアログを開きます。

名前フィールドにフィールドの名前を入力します。 たとえば、File1です。

ファイル添付ドロップダウンメニューを使用して、はいを選択します。

リクエストボディフィールドを追加

フィールドを追加をクリックします。 これにより、使用できる要素専用の"ヘッダー"が追加されます。

マルチパートリクエストで複数のヘッダーが必要な場合は、ファイルを添付せずにこの要素を使用できます。

リクエストボディスキーマとリクエストスキーマフィールド

+ フィールドを追加をクリックし、前の手順を繰り返して、マルチパートリクエストで送信する追加ファイル用のフィールドを作成します。

手動で設定をクリックします。

リクエストセクションに移動し、メソッドドロップダウンメニューを使用して、マルチパートフォームリクエストをサポートする次のいずれかのメソッドを選択します:

• POST
• PUT
• PATCH
• DELETE

リクエストURLフィールドにAPIエンドポイントの絶対URLを入力します。 または、コネクション設定でベースURLを設定している場合は、相対URLを入力します。 たとえば、ベースURLがhttps://api.example.com/で絶対URLがhttps://api.example.com/users/123の場合、相対URLはusers/123です。

リクエストコンテンツタイプドロップダウンメニューを使用して、次のいずれかを選択します:

• Multipart alternative
• Multipart digest
• Multipart mixed
• Multipart related

各マルチパートタイプの詳細については、マルチパートペイロードの操作セクションを参照してください。

リクエストパーツセクションに移動します。 このセクションでは、リクエストの複数のパーツを定義します。各パーツには独自のヘッダーとボディコンテンツがあります。

リクエストパーツセクション

...（省略記号）をクリックして、Fixed listまたはDynamic listを選択します。

パーツの総数とそのコンテンツが分かっている場合は、固定リストを選択します。 パーツの数またはそのコンテンツがリストに依存する場合は、動的リストを選択します。

ヘッダーセクションに移動します。 このセクションでは、各リクエストパーツのヘッダーを定義します。

ヘッダーセクション

...（省略記号）をクリックして、Fixed listまたはDynamic listを選択します。

ヘッダーの総数とそのコンテンツが分かっている場合は、固定リストを選択します。 ヘッダーの数またはそのコンテンツがリストに依存する場合は、動的リストを選択します。

Raw bodyフィールドにパーツのコンテンツを入力します。

任意です。 リクエストがDELETE操作の場合は、リクエストURLパラメーターセクションに移動してURLパラメーターを定義します。

リクエストヘッダーセクションに移動します。 このセクションでは、個々のパーツではなくリクエスト全体に適用されるヘッダーを定義します。

リクエストヘッダーセクション

ヘッダーを追加をクリックし、リクエストに含める各ヘッダーのヘッダー名と値を入力します。

任意です。 マルチパートタイプがrelatedの場合は、次の追加フィールドを設定します:

Content-Type: multipart/related; boundary=f32f23tv-dydb-46c2-aa18-5e0792f9a0b0; type="Application/X-FixedRecord"; start="<[email protected]>"; start-info="-o ps"

任意です。 Boundaryフィールドにペイロードのカスタム境界を入力します。 このフィールドを空白のままにすると、Workatoは境界を自動的に生成します。

このフィールドの最大長は70文字で、次をサポートしています:

• 英数字（A～Z、a～z、0～9）
• アポストロフィ（'）
• 括弧（( )）
• プラス（+）
• アンダースコア（_）
• カンマ（,）
• ハイフン（-）
• ピリオド（.）
• スラッシュ（/）
• コロン（:）
• 等号（=）
• 疑問符（?）

レスポンスコンテンツタイプドロップダウンメニューを使用して、マルチパートを選択します。

WorkatoはレスポンスのContent-Typeヘッダーから境界を自動的に検出します。

たとえば、APIが次を返す場合、Workatoは----Boundary123を抽出し、それを使用してレスポンスパーツを解析します:

Content-Type: multipart/mixed; boundary=----Boundary123

境界がない場合、Workatoはエラーをスローします。

エンコーディング方法を選択するには、エンコーディングドロップダウンメニューを使用します。

HTTPレスポンスヘッダーセクションとマルチパートパーツヘッダーセクションの両方で、次の手順を完了します。 HTTPレスポンスヘッダーセクションではレスポンスレベルで抽出するヘッダーを定義し、マルチパートパーツヘッダーセクションでは個々のパーツから抽出するヘッダーを定義します。

2xx以外のレスポンスを成功としてマークするかどうかを選択するには、2xx以外のレスポンスコードを成功としてマークしますか?ドロップダウンメニューを使用します。 WorkatoのHTTP connectorは、デフォルトで2xx以外のレスポンスコードをエラーとして扱います。 これにより、エラー処理ステップがない限り、ジョブは停止します。