HTTPリクエスト接続は、これらのコマンドを実行して、指定されたURLへの一般的なハイパーテキスト転送プロトコル(HTTP)リクエストを実行し、それぞれのコネクターを介してサポートされているソリューションに接続し、自動化します。
HTTP リクエストがどのように構造化されるかについては、HTTP コネクターのサンプルリストを参照してください。
メモ: HTTP Request とラベル付けされていますが、HTTPS (Secure HTTP) がサポートされています (および推奨)。
要件
- この接続には OData 固有の機能はありませんが、ヘッダー またはクエリ文字列 パラメータを使って、リクエストに必要なコンポーネントを追加することができます。
-
相互TLS(mTLS)認証 を有効にするには、公開/秘密キー・ペアと、オプションとしてCA証明書を提供する。公開鍵と秘密鍵を使用するには、をワークスペース・リソース としてアップロードし、コマンドの証明書 と証明書秘密鍵 のパラメータにそれぞれ選択する。
- 秘密鍵を含むファイルは暗号化されてはいけません。暗号化されたファイルを秘密鍵として読み込むとエラーになります。
これらのコマンドを有効にするために、IT管理者はまずHTTP Requestコネクタ を作成する。
削除
リソースを削除するには、Delete コマンドを使用します。このコマンドは、http://postman-echo.com/delete のようなHTTPDELETE リクエストを行う。
プロパティ
| プロパティ |
詳細 |
| ユーザー名 |
ベーシック認証が必要な場合は、ユーザー名を入力します。 |
| パスワード |
ベーシック認証が必要な場合は、パスワードを入力する。 |
| CA 証明書 |
依頼時に使用する認証局(CA)証明書を入力します(オプション)。 |
| 証明書 |
依頼書とともに送信する証明書を入力します(オプション)。提供される場合、証明書秘密鍵を入力する。 |
| 証明書秘密キー |
証明書 の秘密鍵が提供されている場合は入力する。 |
| 回答表示 |
出力にAPIレスポンス本文を表示するには、このボックスをチェックします。 |
| URL |
http://postman-echo.com/delete のように、依頼に使用するURLを入力します。 |
| コンテンツタイプ |
設定するコンテンツタイプヘッダーを入力します。これはリクエスト本文に送る書式を指定します。 |
| 本文ファイル |
リクエスト本文に送信するJSONオブジェクトまたはリクエストパラメータを含むファイルを入力します。これを含む場合は、本文 は空白のままにしてください。 |
| 本文 |
リクエスト本文に送信するテキストを入力します。これを含む場合は、本文ファイル は空白のままにしておく。 |
| ヘッダー |
リクエストに追加するヘッダーを入力します。 |
出力
| 出力 |
出力タイプ |
| レスポンスヘッダー |
JSON |
| 応答 |
ファイル |
| 応答コード |
整数 |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
リクエストに失敗しました: 200ではないリスポンスコード |
| 4 |
エラー |
証明書が検索されませんでした |
| 5 |
エラー |
無効なリクエストヘッダ |
インテリジェントで、
リソースを取得するには、Get コマンドを使用する。このコマンドは、https://postman-echo.com/get?foo1=bar1&foo2=bar2 のようなHTTPGET リクエストを行う。
注: このコマンドにはクエリパラメータを入力するためのスペースが含まれています -- パラメータは、URLそのものに含まれていません。パラメータがURLと "クエリ文字列 "フィールドの両方に入力されている場合、それらはURLから取り除かれます。
プロパティ
| プロパティ |
詳細 |
| ユーザー名 |
ベーシック認証が必要な場合は、ユーザー名を入力します。 |
| パスワード |
ベーシック認証が必要な場合は、パスワードを入力する。 |
| CA 証明書 |
依頼時に使用する CA 証明書を入力します(オプション)。 |
| 証明書 |
依頼書とともに送信する証明書を入力します(オプション)。提供される場合、証明書秘密鍵を入力する。 |
| 証明書秘密キー |
証明書 の秘密鍵が提供されている場合は入力する。 |
| 回答表示 |
出力にAPIレスポンス本文を表示するには、このボックスをチェックします。 |
| URL |
https://postman-echo.com/get のように、リクエストに使用するURLを入力します。 |
| クエリ文字列 |
foo1=bar1&foo2=bar2 のように、リクエストに追加するクエリ文字列を入力します。 メモ: クエリ文字列はエンコードされていなければならない。 |
| ヘッダー |
リクエストに追加するヘッダーを入力します。 |
| コンテンツタイプ |
application/json のように、設定するコンテンツタイプヘッダーを入力する。これはリクエスト本文に送る書式を指定します。 |
| 出力スキーマ |
チェーン内の後のコマンドがこのコマンドの出力プロパティに使用できるようにするには、各JSON出力のサンプルペイロードを入力します。 |
出力
| 出力 |
出力タイプ |
| レスポンスヘッダー |
JSON |
| 応答 |
ファイル |
| 応答コード |
整数 |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
リクエストに失敗しました: 200ではないリスポンスコード |
| 4 |
エラー |
証明書が検索されませんでした |
| 5 |
エラー |
無効なリクエストヘッダ |
投稿
リソースを配置するには、Post コマンドを使用する。このコマンドは、https://postman-echo.com/post のようなHTTPPOST リクエストを行う。
プロパティ
| プロパティ |
詳細 |
| ユーザー名 |
ベーシック認証が必要な場合は、ユーザー名を入力します。 |
| パスワード |
ベーシック認証が必要な場合は、パスワードを入力する。 |
| CA 証明書 |
依頼時に使用する CA 証明書を入力します(オプション)。 |
| 証明書 |
依頼書とともに送信する証明書を入力します(オプション)。提供される場合、証明書秘密鍵を入力する。 |
| 証明書秘密キー |
証明書 の秘密鍵が提供されている場合は入力する。 |
| 回答表示 |
出力にAPIレスポンス本文を表示するには、このボックスをチェックします。 |
| URL |
https://postman-echo.com/post のように、リクエストに使用されるURLを入力します。 |
| コンテンツタイプ |
設定するコンテンツタイプヘッダーを入力します。これはリクエスト本文に送る書式を指定します。 メモ: マルチパートデータの場合は、フォーム値 を追加して本文を生成する。 |
| 本文ファイル |
リクエスト本文に送信するJSONオブジェクトまたはリクエストパラメータを含むファイルを入力します。これを含む場合は、本文 は空白のままにしてください。 |
| 本文 |
リクエスト本文に送信するテキストを入力します。これを含む場合は、本文ファイル は空白のままにしておく。 |
| ヘッダー |
リクエストに追加するヘッダーを入力します。 |
| フォーム値 |
マルチパートデータの本文を生成するには、リクエストに含むフォーム値を追加し、それぞれの名称と値を入力します。フォーム値を追加する場合は、コンテンツタイプ を空白のままにする。 |
| 出力スキーマ |
チェーン内の後のコマンドがこのコマンドの出力プロパティに使用できるようにするには、各JSON出力のサンプルペイロードを入力します。 |
出力
| 出力 |
出力タイプ |
| レスポンスヘッダー |
JSON |
| 応答 |
ファイル |
| レスポンスコード |
整数 |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
リクエストに失敗しました: 200ではないリスポンスコード |
| 4 |
エラー |
証明書が検索されませんでした |
| 5 |
エラー |
無効なリクエストヘッダ |
置く
リソースを変更または更新するには、Put コマンドを使用する。このコマンドは、https://postman-echo.com/put のようなHTTPPUT リクエストを行う。
プロパティ
| プロパティ |
詳細 |
| ユーザー名 |
ベーシック認証が必要な場合は、ユーザー名を入力します。 |
| パスワード |
ベーシック認証が必要な場合は、パスワードを入力する。 |
| CA 証明書 |
依頼時に使用する CA 証明書を入力します(オプション)。 |
| 証明書 |
依頼書とともに送信する証明書を入力します(オプション)。提供される場合、証明書秘密鍵を入力する。 |
| 証明書秘密キー |
証明書 の秘密鍵が提供されている場合は入力する。 |
| 回答表示 |
出力にAPIレスポンス本文を表示するには、このボックスをチェックします。 |
| URL |
リクエストに使用するURLを入力します。 |
| コンテンツタイプ |
設定するコンテンツタイプヘッダーを入力します。これはリクエスト本文に送る書式を指定します。 メモ: マルチパートデータの場合は、フォーム値 を追加して本文を生成する。 |
| 本文ファイル |
リクエスト本文に送信するJSONオブジェクトまたはリクエストパラメータを含むファイルを入力します。これを含む場合は、本文 は空白のままにしてください。 |
| 本文 |
リクエスト本文に送信するテキストを入力します。これを含む場合は、本文ファイル は空白のままにしておく。 |
| ヘッダー |
リクエストに追加するヘッダーを入力します。 |
| フォーム値 |
マルチパートデータの本文を生成するには、リクエストに含むフォーム値を追加し、それぞれの名称と値を入力します。フォーム値を追加する場合は、コンテンツタイプ を空白のままにする。 |
| 出力スキーマ |
チェーン内の後のコマンドがこのコマンドの出力プロパティに使用できるようにするには、各JSON出力のサンプルペイロードを入力します。 |
出力
| 出力 |
出力タイプ |
| レスポンスヘッダー |
JSON |
| 応答 |
ファイル |
| 応答コード |
整数 |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
リクエストに失敗しました: 200ではないリスポンスコード |
| 4 |
エラー |
証明書が検索されませんでした |
| 5 |
エラー |
無効なリクエストヘッダ |