HTTPリクエストコマンド

HTTP Requests接続は、これらのコマンドを実行して、指定されたURLへの一般的なHTTP（HyperText Transfer Protocol）リクエストを実行し、それぞれのコネクタを介してサポートされているソリューションに接続し、自動化します。

HTTP リクエストがどのように構造化されるかについては、HTTP Connector のサンプルリストを参照してください。

要件

接続には OData 固有の機能はありませんが、Headers またはQuery string パラメータを使って、リクエストに必要なコンポーネントを追加することができます。
相互TLS（mTLS）認証を有効にするには、公開/秘密鍵ペアと、オプションでCA証明書を提供する。公開鍵と秘密鍵を使用するには、をワークスペース・リソースとしてアップロードし、コマンドの証明書 と証明書秘密鍵 パラメータでそれぞれ選択する。

これらのコマンドを有効にするには、IT 管理者はまずHTTP リクエストコネクタを作成します。

削除

リソースを削除するには、Delete コマンドを使用します。このコマンドは、http://postman-echo.com/delete のようなHTTPDELETE リクエストを行う。

プロパティ

プロパティ	詳細
ユーザー名	ベーシック認証が必要な場合は、ユーザー名を入力する。
パスワード	ベーシック認証が必要な場合は、パスワードを入力する。
CA 証明書	リクエスト時に使用する認証局（CA）証明書を入力します（オプション）。
証明書	リクエストと共に送信する証明書を入力します（オプション）。提供されている場合は、証明書秘密鍵も入力する。
証明書の秘密鍵	証明書の秘密鍵が提供されている場合は、それを入力する。
回答を表示する	出力にAPIレスポンス・ボディを表示するには、このボックスをチェックします。
URL	`http://postman-echo.com/delete` のように、リクエストに使用するURLを入力してください。
コンテンツタイプ	設定するcontent-typeヘッダーを入力する。これは、リクエストボディに送る期待されるフォーマットを指定する。
ボディファイル	リクエスト・ボディに送信するJSONオブジェクトまたはリクエスト・パラメータを含むファイルを入力します。これを含める場合は、本文は空白のままにしてください。
本文	リクエスト本文に送信するテキストを入力します。これを含める場合は、ボディファイルを空白のままにしてください。
ヘッダー	リクエストに追加するヘッダーを入力します。

出力

出力	出力タイプ
レスポンス・ヘッダ	JSON
応答	ファイル
応答コード	整数

終了コード

コード	タイプ	詳細
0	成功	成功
2	エラー	リクエストに失敗。
4	エラー	証明書が見つかりません
5	エラー	無効なリクエストヘッダ

取得

リソースを取得するには、Get 。このコマンドは、HTTPGET リクエスト、例えばhttps://postman-echo.com/get?foo1=bar1&foo2=bar2 を実行する。

注：このコマンドには、クエリーパラメーターを入力するためのスペースが含まれている。パラメータがURLと "クエリー文字列 "フィールドの両方に入力されている場合、それらはURLから取り除かれる。

プロパティ

プロパティ	詳細
ユーザー名	ベーシック認証が必要な場合は、ユーザー名を入力する。
パスワード	ベーシック認証が必要な場合は、パスワードを入力する。
CA 証明書	リクエスト時に使用するCA証明書を入力する（オプション）。
証明書	リクエストと共に送信する証明書を入力します（オプション）。提供されている場合は、証明書秘密鍵も入力する。
証明書の秘密鍵	証明書の秘密鍵が提供されている場合は、それを入力する。
回答を表示する	出力にAPIレスポンス・ボディを表示するには、このボックスをチェックします。
URL	`https://postman-echo.com/get` のように、リクエストに使用するURLを入力してください。
クエリー文字列	`foo1=bar1&foo2=bar2` のように、リクエストに追加するクエリー文字列を入力する。注：クエリー文字列はエンコードされていなければならない。
ヘッダー	リクエストに追加するヘッダーを入力します。
コンテンツタイプ	`application/json` のように、設定するcontent-typeヘッダーを入力してください。これは、リクエストボディに送る期待されるフォーマットを指定する。
出力スキーマ	チェイン内の後続のコマンドがこのコマンドの出力プロパティにアクセスできるようにするには、各JSON出力のサンプル・ペイロードを入力する。

出力

出力	出力タイプ
レスポンス・ヘッダ	JSON
応答	ファイル
応答コード	整数

終了コード

コード	タイプ	詳細
0	成功	成功
2	エラー	リクエストに失敗。
4	エラー	証明書が見つかりません
5	エラー	無効なリクエストヘッダ

投稿

リソースを配置するには、Post 。このコマンドは、https://postman-echo.com/post のようなHTTPPOST リクエストを行う。

プロパティ

プロパティ	詳細
ユーザー名	ベーシック認証が必要な場合は、ユーザー名を入力する。
パスワード	ベーシック認証が必要な場合は、パスワードを入力する。
CA 証明書	リクエスト時に使用する CA 証明書を入力する（オプション）。
証明書	リクエストと共に送信する証明書を入力します（オプション）。提供されている場合は、証明書秘密鍵も入力する。
証明書の秘密鍵	証明書の秘密鍵が提供されている場合は、それを入力する。
回答を表示する	出力にAPIレスポンス・ボディを表示するには、このボックスをチェックします。
URL	`https://postman-echo.com/post` のように、リクエストに使用するURLを入力してください。
コンテンツタイプ	設定するcontent-typeヘッダーを入力する。これは、リクエストボディに送る期待されるフォーマットを指定する。注：マルチパートデータの場合は、フォームの値を追加して、ボディを生成する。
ボディファイル	リクエスト・ボディに送信するJSONオブジェクトまたはリクエスト・パラメータを含むファイルを入力します。これを含める場合は、本文は空白のままにしてください。
本文	リクエスト本文に送信するテキストを入力します。これを含める場合は、ボディファイルを空白のままにしてください。
ヘッダー	リクエストに追加するヘッダーを入力します。
フォームの値	マルチパートデータのボディを生成するには、リクエストに含めるフォーム値を追加し、それぞれの名前と値を入力します。フォーム値を追加する場合は、コンテンツタイプを空白のままにします。
出力スキーマ	チェイン内の後続のコマンドがこのコマンドの出力プロパティにアクセスできるようにするには、各JSON出力のサンプル・ペイロードを入力する。

出力

出力	出力タイプ
レスポンス・ヘッダ	JSON
応答	ファイル
レスポンスコード	整数

終了コード

コード	タイプ	詳細
0	成功	成功
2	エラー	リクエストに失敗。
4	エラー	証明書が見つかりません
5	エラー	無効なリクエストヘッダ

置く

リソースを変更または更新するには、Put 。このコマンドは、https://postman-echo.com/put のようなHTTPPUT リクエストを行う。

プロパティ

プロパティ	詳細
ユーザー名	ベーシック認証が必要な場合は、ユーザー名を入力する。
パスワード	ベーシック認証が必要な場合は、パスワードを入力する。
CA 証明書	リクエスト時に使用する CA 証明書を入力する（オプション）。
証明書	リクエストと共に送信する証明書を入力します（オプション）。提供されている場合は、証明書秘密鍵も入力する。
証明書の秘密鍵	証明書の秘密鍵が提供されている場合は、それを入力する。
回答を表示する	出力にAPIレスポンス・ボディを表示するには、このボックスをチェックします。
URL	リクエストに使用するURLを入力します。
コンテンツタイプ	設定するcontent-typeヘッダーを入力する。これは、リクエストボディに送る期待されるフォーマットを指定する。注：マルチパートデータの場合は、フォームの値を追加して、ボディを生成する。
ボディファイル	リクエスト・ボディに送信するJSONオブジェクトまたはリクエスト・パラメータを含むファイルを入力します。これを含める場合は、本文は空白のままにしてください。
本文	リクエスト本文に送信するテキストを入力します。これを含める場合は、ボディファイルを空白のままにしてください。
ヘッダー	リクエストに追加するヘッダーを入力します。
フォームの値	マルチパートデータのボディを生成するには、リクエストに含めるフォーム値を追加し、それぞれの名前と値を入力します。フォーム値を追加する場合は、コンテンツタイプを空白のままにしてください。
出力スキーマ	チェイン内の後続のコマンドがこのコマンドの出力プロパティにアクセスできるようにするには、各JSON出力にサンプル・ペイロードを入力する。

出力

出力	出力タイプ
レスポンス・ヘッダ	JSON
応答	ファイル
応答コード	整数

終了コード

コード	タイプ	詳細
0	成功	成功
2	エラー	リクエストに失敗。
4	エラー	証明書が見つかりません
5	エラー	無効なリクエストヘッダ

サポート

Workiva サポートセンター