HTTP 請求指令

HTTP Requests 連線會執行這些指令，以對指定的 URL 執行一般的超文字傳輸協定 (HTTP) 請求，並透過其各自的連接器連接和自動化支援的解決方案。

要瞭解 HTTP 請求的結構，請參閱我們的HTTP Connector 示例清單。

附註：雖然此標籤為 HTTP Request，但支援 HTTPS (Secure HTTP)（並建議使用）。

需求

雖然連線沒有 OData 特有的功能，但您可以透過Headers 或Query string 參數，新增請求的任何必要元件。
要启用相互 TLS (mTLS) 身份验证，请提供一对公钥/私钥，并可选择提供 CA 证书。若要使用公開金鑰和私人密碼匙，上傳它們作為工作區資源，然後分別為指令的憑證和憑證私人密碼匙 參數選擇它們。
包含私密金鑰的檔案必須未加密。以私人密碼匙載入加密檔案會導致錯誤。

要啟用這些指令，IT 管理員首先建立 HTTP 請求連接器。

刪除

要移除資源，請使用Delete 指令。此命令會發出 HTTPDELETE 請求，例如http://postman-echo.com/delete 。

摘要資訊

摘要資訊	詳細資訊
使用者名稱	如果需要基本驗證，請輸入使用者名稱。
密碼	如果需要基本驗證，請輸入密碼。
CA 憑證	輸入提出請求時要使用的憑證授權機構 (CA) 憑證 (選用)。
憑證	輸入要隨同請求傳送的憑證 (選用)。如果提供，也請輸入憑證私人密碼匙。
憑證私人密碼匙	輸入憑證的私密金鑰 (如果有提供)。
顯示回應	若要在輸出中顯示 API 回應正文，請勾選此方塊。
URL	輸入請求使用的 URL，例如`http://postman-echo.com/delete` 。
內容類型	輸入要設定的 content-type 標頭。這會指定傳送至要求正文的預期格式。
正文檔案	輸入包含要在請求體中傳送的 JSON 物件或請求參數的檔案。如果包含此項，請將Body text 留空。
本文	輸入要在要求正文中傳送的文字。如果包含此項，請將Body file 留空。
頁首	輸入任何要新增至請求的附加標頭。

输出

輸出	輸出類型
回應標頭	JSON
回覆	檔案
回應碼	整數

退出代碼

代碼	類型	詳細資訊
0	成功	成功
2	錯誤	請求失敗；非-200 回應代碼
4	錯誤	未找到憑證
5	錯誤	無效的請求標的

取得

若要擷取資源，請使用Get 指令。此命令會發出 HTTPGET 請求，例如https://postman-echo.com/get?foo1=bar1&foo2=bar2 。

註記: 此指令包含一個空格以輸入查詢參數 -- 參數不應包含在 URL 本身。如果在 URL 和「查詢字串」欄位中輸入參數，則會從 URL 中剔除這些參數。

摘要資訊

摘要資訊	詳細資訊
使用者名稱	如果需要基本驗證，請輸入使用者名稱。
密碼	如果需要基本驗證，請輸入密碼。
CA 憑證	輸入提出請求時要使用的 CA 憑證 (選用)。
憑證	輸入要隨同請求傳送的憑證 (選用)。如果提供，也請輸入憑證私人密碼匙。
憑證私人密碼匙	輸入憑證的私密金鑰 (如果有提供)。
顯示回應	若要在輸出中顯示 API 回應正文，請勾選此方塊。
URL	輸入請求使用的 URL，例如`https://postman-echo.com/get` 。
查詢字串	輸入要附加到請求的查詢字串，例如`foo1=bar1&foo2=bar2` 。注意：查詢字串必須編碼。
頁首	輸入要加入請求的任何其他標頭。
內容類型	輸入要設定的 content-type 標頭，例如`application/json` 。這指定要傳送至請求體的預期格式。
輸出模式	若要使連鎖中的後續指令能存取此指令的輸出屬性，請為每個 JSON 輸出輸入樣本有效載荷。

输出

輸出	輸出類型
回應標頭	JSON
回覆	檔案
回應碼	整數

退出代碼

代碼	類型	詳細資訊
0	成功	成功
2	錯誤	請求失敗；非-200 回應代碼
4	錯誤	未找到憑證
5	錯誤	無效的請求標的

張貼

要放置資源，請使用Post 指令。該命令會發出 HTTPPOST 請求，例如https://postman-echo.com/post 。

摘要資訊

摘要資訊	詳細資訊
使用者名稱	如果需要基本驗證，請輸入使用者名稱。
密碼	如果需要基本驗證，請輸入密碼。
CA 憑證	輸入提出請求時要使用的 CA 憑證 (選用)。
憑證	輸入要隨同請求傳送的憑證 (選用)。如果提供，也請輸入憑證私人密碼匙。
憑證私人密碼匙	輸入憑證的私密金鑰 (如果有提供)。
顯示回應	若要在輸出中顯示 API 回應正文，請勾選此方塊。
URL	輸入請求使用的 URL，例如`https://postman-echo.com/post` 。
內容類型	輸入要設定的 content-type 標頭。這指定要傳送至請求體的預期格式。注意：對於多部分資料，請加入表格值來產生正文。
正文檔案	輸入包含要在請求體中傳送的 JSON 物件或請求參數的檔案。如果包含此項，請將Body text 留空。
本文	輸入要在要求正文中傳送的文字。如果包含此項，請將Body file 留空。
頁首	輸入要加入請求的任何附加標頭。
表單值	若要為多部分資料產生正文，請加入要包含在請求中的表單數值，並輸入每個數值的名稱和值。如果添加表單值，請將內容類型留空。
輸出模式	若要使連鎖中的後續指令能存取此指令的輸出屬性，請為每個 JSON 輸出輸入樣本有效載荷。

输出

輸出	輸出類型
回應標頭	JSON
回覆	檔案
回應碼	整數

退出代碼

代碼	類型	詳細資訊
0	成功	成功
2	錯誤	請求失敗；非-200 回應代碼
4	錯誤	未找到憑證
5	錯誤	無效的請求標的

Put

要變更或更新資源，請使用Put 指令。此命令會發出 HTTPPUT 請求，例如https://postman-echo.com/put 。

摘要資訊

摘要資訊	詳細資訊
使用者名稱	如果需要基本驗證，請輸入使用者名稱。
密碼	如果需要基本驗證，請輸入密碼。
CA 憑證	輸入提出請求時要使用的 CA 憑證 (選用)。
憑證	輸入要隨同請求傳送的憑證 (選用)。如果提供，也請輸入憑證私人密碼匙。
憑證私人密碼匙	輸入憑證的私密金鑰 (如果有提供)。
顯示回應	若要在輸出中顯示 API 回應正文，請勾選此方塊。
URL	輸入請求使用的 URL。
內容類型	輸入要設定的 content-type 標頭。這指定要傳送至請求體的預期格式。注意：對於多部分資料，請加入表格值來產生正文。
正文檔案	輸入包含要在請求體中傳送的 JSON 物件或請求參數的檔案。如果包含此項，請將Body text 留空。
本文	輸入要在要求正文中傳送的文字。如果包含此項，請將Body file 留空。
頁首	輸入要加入請求的任何附加標頭。
表單值	若要為多部分資料產生正文，請加入要包含在請求中的表單數值，並輸入每個數值的名稱和值。如果添加表單值，請將內容類型留空。
輸出模式	若要使連鎖中的後續指令能存取此指令的輸出屬性，請為每個 JSON 輸出輸入樣本有效載荷。

输出

輸出	輸出類型
回應標頭	JSON
回覆	檔案
回應碼	整數

退出代碼

代碼	類型	詳細資訊
0	成功	成功
2	錯誤	請求失敗；非-200 回應代碼
4	錯誤	未找到憑證
5	錯誤	無效的請求標的

支援

社群

Workiva 支援中心

HTTP 請求指令

附註：雖然此標籤為 HTTP Request，但支援 HTTPS (Secure HTTP)（並建議使用）。

需求

刪除

摘要資訊

输出

退出代碼

取得

註記: 此指令包含一個空格以輸入查詢參數 -- 參數不應包含在 URL 本身。如果在 URL 和「查詢字串」欄位中輸入參數，則會從 URL 中剔除這些參數。

摘要資訊

注意：查詢字串必須編碼。

输出

退出代碼

張貼

摘要資訊

注意：對於多部分資料，請加入表格值來產生正文。

输出

退出代碼

Put

摘要資訊

注意：對於多部分資料，請加入表格值來產生正文。

输出

退出代碼

Workiva 支援中心

HTTP 請求指令

附註： 雖然此標籤為 HTTP Request，但支援 HTTPS (Secure HTTP)（並建議使用）。

需求

刪除

摘要資訊

输出

退出代碼

取得

註記: 此指令包含一個空格以輸入查詢參數 -- 參數不應包含在 URL 本身。如果在 URL 和 「查詢字串 」欄位中輸入參數，則會從 URL 中剔除這些參數。

摘要資訊

注意： 查詢字串必須編碼。

输出

退出代碼

張貼

摘要資訊

注意： 對於多部分資料，請加入表格值 來產生正文。

输出

退出代碼

Put

摘要資訊

注意： 對於多部分資料，請加入表格值 來產生正文。

输出

退出代碼

附註：雖然此標籤為 HTTP Request，但支援 HTTPS (Secure HTTP)（並建議使用）。

註記: 此指令包含一個空格以輸入查詢參數 -- 參數不應包含在 URL 本身。如果在 URL 和「查詢字串」欄位中輸入參數，則會從 URL 中剔除這些參數。

注意：查詢字串必須編碼。

注意：對於多部分資料，請加入表格值來產生正文。

注意：對於多部分資料，請加入表格值來產生正文。