核心功能
- 完整的 RESTful API 用戶端，支援所有 HTTP 方法（GET、POST、PUT、PATCH 和 DELETE）
- 支援 Swagger 匯入，可自動配置 API 並生成請求
- 支援高階身分驗證，包括 OAuth 2.0、Bearer Token、AWS Signature 以及 Basic/Digest 認證
- 支援在 URL、標頭和表單資料中使用 ArcScript 構建動態請求
- 靈活的正文型別，包括 raw、form-data、URL-encoded 和檔案上傳
概觀
REST 端口提供簡單介面，用於構建 REST 請求的標頭、授權、正文和 HTTP 方法。請求正文可以在端口配置中靜態設定，也可以根據端口處理的檔案動態生成。操作
端口設定
REST 頁面
與端口請求詳細資訊相關的設定。
認證
與 REST 服務認證相關的設定。請求詳情
| 設定 | 說明 |
|---|---|
| 從 Swagger 匯入 | 單擊  圖示可直接從 Swagger URL 匯入 API 詳細資訊。 |
| 測試 | 測試當前配置，而不建立傳送到工作流程下游的訊息或交易。單擊測試會開啟包含四個索引標籤的視窗（更多資訊請參見測試請求配置）： 回應正文：檢視來自伺服器的回應正文。 回應標頭：檢視伺服器回應中包含的標頭。 訊息標頭：檢視測試輸出中包含的訊息標頭。 日誌：檢視端口日誌。 |
| 操作 | 端口應執行的操作。（有關三個選項的詳細資訊，請參見操作。） |
| 請求 URL | REST 請求的 HTTP 方法和目標 HTTP URL。可用方法選項包括：GET、POST、PUT、PATCH 和 DELETE。 |
| 正文型別 | 隨 REST 請求提供的正文內容類型。當 HTTP 方法為 GET 時不可見。有關每個選項的說明，請參見正文型別。 |
| 標頭 | 標頭索引標籤支援新增要包含在傳出 REST 請求中的 HTTP 標頭清單。標頭以名稱-值對指定。更多資訊請參見靜態請求。 |
| 正文 | 如果正文型別設定為 form-data 或 x-www-urlencoded，請使用正文索引標籤提供一組構成請求正文的名稱-值對（欄位）。詳情請參見正文型別。 |
設定頁面
與端口核心配置相關的設定。配置
進階設定
高階頁面
TLS 用戶端認證
進階設定
不屬於前述類別的設定。代理設定
日誌
其他設定
自動化
自動化設定
與端口自動處理檔案相關的設定。效能
告警索引標籤
SLA 索引標籤
交易索引標籤
此索引標籤列出與端口關聯的所有訊息。使用搜尋欄查詢特定訊息，或單擊漏斗圖示應用篩選器。可以按時間、訊息方向和/或狀態進行篩選。 此索引標籤上的選項因端口的操作型別而異：- 如果端口是 Trigger，請使用接收檔案按鈕啟動工作流程。
- 如果端口是 Transform 或 Terminal，請使用上傳檔案按鈕將檔案上傳到工作流程。
建立連線
與任何 REST 服務建立連線都需要有效的目標 URL。服務 URL 可以支援各種 HTTP 方法，你應根據特定 Web 服務操作或要檢索的資料集配置方法。某些服務可能還需要身分驗證或一組自定義標頭才能使用該服務。 如果目標 URL 是 HTTPS URL，請將 TLS 伺服器憑證設定為標識伺服器的公開金鑰憑證。若要隱式信任目標端點，請將該欄位設定為Any Certificate。
認證方式
REST 端口支援多種身分驗證型別，每種型別都有自己的要求：- Basic（純文字）、Digest（加密）和 NTLM 需要使用者名稱-密碼身分驗證。這些憑據會作為請求中的標頭提供給 REST 服務。
- OAuth 身分驗證需要在 REST 服務的 Web 門戶或開發控制檯中註冊應用。應用註冊中要包含的 Callback URL 會顯示在 UI 中。選擇適用於 REST 服務的 Grant Type，並根據 REST 服務 Web 門戶或開發控制檯中顯示的詳細資訊指定其餘設定。然後單擊取得新的存取權杖以取得與服務互動所需的權杖。檢索到初始權杖後，應用程式會在權杖即將過期時重新整理它們。
- Bearer Token 身分驗證需要來自服務 Web 門戶或開發控制檯的權杖。
- AWS Signature 身分驗證用於對 Amazon 進行身分驗證，需要配置 Amazon 提供的憑據：Access Key、Secret Key 等。
測試請求配置
你可以隨時測試當前配置，而不建立傳送到工作流程下游的訊息或交易。單擊 REST 詳情索引標籤上的測試。下圖顯示了成功測試後的回應正文結果。
- 回應正文：以伺服器傳回的格式顯示 REST 請求的輸出。
- 回應標頭：顯示伺服器傳回回應中包含的回應標頭。
- 訊息標頭：顯示測試輸出中包含的訊息標頭。
- 日誌：顯示測試日誌。
正文型別
使用端口的請求詳情索引標籤指定正文的配置方式以及提供的資訊型別。以下清單更詳細地說明了每個選項。- none：REST 請求不提供正文。
- form-data：正文以一組名稱-值對（欄位）提供。使用 Name 旁邊的下拉式清單選擇欄位型別。
- Static：同時提供 Name 和 Value。
- XML：在 UI 中提供 Name。Value 會從端口處理的輸入檔案中動態讀取。更多資訊請參見動態表單資料。
- File：每個端口可以有一個正文欄位設定為 File。這會使輸入檔案作為請求正文傳送。由於端口使用輸入檔案本身作為表單資料，因此 Value 欄位會變灰。
注意：File 選項與動態請求和其他檔案請求不相容。如果使用此選項，只能將其與靜態欄位結合使用。 - Header：使用 Value 欄位指定從輸入訊息的哪個標頭讀取正文。
- ArcScript：提供的 Value 會渲染為 ArcScript，結果值會用於請求正文。
- x-www-urlencoded：正文的配置方式與 form-data 相同；但名稱-值對會編碼為 URL 查詢字串，而不是多部分表單資料。
- raw：正文設定為端口處理的輸入檔案內容。使用下拉式清單選擇正文的內容類型，或在標頭部分將其指定為自定義標頭。
靜態請求
內容完全靜態的 REST 請求（例如使用 HTTP GET 方法的請求）不需要輸入檔案，因為請求內容完全在端口 UI 中配置。只需在標頭部分新增任何必要的名稱-值對作為自定義標頭，或在正文部分新增表單資料。 如果啟用接收自動化，可以按計劃自動傳送靜態請求。每個請求的回應會儲存在輸出資料夾中，或傳遞給工作流程中的下一個端口。 如果啟用傳送自動化，到達端口輸入資料夾的檔案也會觸發靜態請求。輸入檔案的內容會被忽略，請求會根據 UI 中的配置傳送。動態請求
REST 請求可以使用到達端口輸入資料夾的檔案中的資料動態填充。原始輸入資料
如果將請求的正文型別設定為raw，輸入檔案的內容會作為 REST 請求正文傳送。
使用內容類型下拉式清單設定資料的特定內容類型。如果所需內容類型未列出，可以在標頭部分新增 Content-Type 標頭。
動態表單資料
如果將請求的正文型別設定為form-data 或 x-www-urlencoded，端口會從輸入檔案中查詢特定值來填充請求。對於設定為 XML 的每個名稱-值對，端口會掃描輸入檔案，查詢與欄位名稱相同且使用特定 XML 結構的 XML 元素，如下所示：
CustomerID 的動態欄位，並且輸入檔案包含如下所示的 XML，則 REST 端口會將 CustomerID 欄位的值設定為 12354。
帶有 XML 對映的動態範本
將 XML Map 端口與 REST 端口結合使用，可以輕鬆從其他 XML 資料結構構建動態請求。XML Map 端口會將自定義 XML 結構轉換為 REST 端口期望的 XML 結構。 首先，為 REST 端口配置請求中應存在的一組動態（和靜態）正文欄位。接下來，在 工作流程中將 XML Map 端口連線到 REST 端口，並儲存工作流程更改。這使 XML Map 端口能夠檢測 REST 端口期望在傳入輸入檔案中出現哪些欄位。 然後，在 XML Map 端口中，目的檔案下拉式清單會包含 REST 請求架構。選擇它作為目標，並將來源檔案設定為自定義 XML 結構。這會填充 XML Map 對映編輯器，你可以將需要包含在 REST 請求中的資料從源結構拖放到目標結構。對映完成後，XML Map 端口會自動將與來源檔案匹配的檔案轉換為有效的 REST 請求結構。 有關使用 XML Map 端口的更多資訊，請參見 XML Map 端口文件。URL
如果在端口配置窗格的高階頁面上選擇允許在 URL 中使用 ArcScript，即可對 ArcScript 中的運算式求值，以生成動態字串作為 URL。例如，以下 URL 包含日期和時間：http://myendpoint.com/api?day=[_ | now('yyyyMMdd')]
此 URL 包含用於透過傳送自動化觸發的查詢的傳入訊息標頭：
http://myendpoint.com/api?customer=[_message.header:customerid]
最後，此 URL 使用從上次查詢時間到當前時間戳的動態日期範圍，併為第一次查詢使用預設時間戳：
http://myendpoint.com/api?DateFrom=[_connector.lastruntimestamp | def('2025-01-01T00:00:00-04:00')]&DateTo=[_connector.currenttimestamp]
標頭
如果在端口配置窗格的高階頁面上選擇允許在標頭中使用 ArcScript，即可對 ArcScript 中的運算式求值，以生成動態字串作為標頭值。例如，以下標頭包含日期和時間：Timestamp [_ | now('yyyyMMdd')]
以下標頭包含用於透過傳送自動化觸發的查詢的客戶 ID：
Customer [_message.header:customerid]
回應事件
可以在 REST 端口中使用回應事件與從伺服器接收的回應（包括正文、標頭、Cookie 等）互動，並豐富端口生成的輸出訊息。可以在Response 事件中使用以下特殊專案。
回應事件 Example
此指令碼讀取從 REST 呼叫接收的 JSON 回應，解析出 JSON 中包含的存取權杖，並將其作為標頭新增到 REST 端口建立的輸出訊息上：_response.body 存取伺服器傳送回知行之橋中 REST 端口的回應正文，並將其設定為 jsonDOMGet 操作的 text 屬性。jsonDOMGet 的其他屬性也會被填充，例如 map 屬性，其中包含回應正文中所需權杖的 jsonpath。
2 呼叫 jsonDOMGet 操作。如果在回應 JSON 正文中找到權杖，則會透過 _message.header:access_token 語法將其作為訊息標頭新增到 REST 端口的輸出訊息。如果未找到權杖，則 access_token 標頭的值會設定為靜態字串：Token not found!。
在 中檢視來自 REST 端口的訊息的輸出訊息詳細資訊時，結果如下所示：
