REST端口支持構建動態REST請求來使用RESTful API網絡
REST端口支持構建動態REST請求來使用RESTful API網絡服務。
概覽
REST端口暴露了一個簡單的接口來為REST請求構建頭、授權、主體和HTTP方法。請求體可以在端口配置中靜態設置，也可以根據端口處理的文件動態生成。
端口配置
配置
與端口核心操作相關的配置。
|
方法&URL |
REST請求的方法和目標網址。 |
|
認證類型 |
REST服務使用的認證類型。有關更多詳細信息，請參見認證部分。 |
頭部
頭部部分支持添加任意列表的HTTP頭部，以包含在傳出的REST請求中。頭部被指定為名稱-值對。當主體類型設置為Raw時，此部分可用于指定消息主體的Content-Type。
消息主體
與生成REST請求主體相關的設置。當HTTP方法設置為“GET”時不適用。
|
主體類型 |
None – REST請求不會提供給任何機構。 form-data – 主體以一組名稱-值對(字段)的形式提供。如果字段設置為靜態，則名稱和值都在用戶界面中指定。對于動態字段，名稱是在用戶界面中指定的，值是從連接器處理的輸入文件中動態讀取的。有關更多信息，請參見動態表單數據部分。 x-www-urlencoded – 主體的配置方式與form-data相同，但是名稱-值對被編碼為一個URL查詢字符串，而不是多部分表單數據。 raw – 主體被設置為端口處理的輸入文件的內容。正文的內容類型可以通過相關聯的下拉菜單設置，或者在標題部分指定為自定義標題。 |
SSL服務器認證
與SSL服務器認證相關的設置。
|
SSL服務器證書 |
用于SSL/TLS服務器認證的公鑰證書。此設置可以設置為“任何證書”，以無條件信任目標服務器的身份。 |
自動
與端口自動處理文件有關的設置。
|
發送 |
到達端口的文件是否會自動觸發REST API調用。 |
|
重試間隔 |
重試失敗的REST請求之前的時間。 |
|
重試最大嘗試次數 |
將重試失敗的REST請求的最大次數。 |
|
接收 |
端口是否應該根據指定的時間間隔自動發送靜態REST請求。請求正文中將不包含任何動態值。 |
|
接收執行間隔 |
自動靜態請求之間的間隔。 |
|
分鐘 |
下載前等待的分鐘數。僅在接收執行間隔設置為分鐘時適用。 |
|
整點過幾分 |
每小時計劃的分鐘偏移量。僅在接收執行間隔設置為每小時時適用。例如，如果該值設置為5，自動化服務將在1:05、2:05、3:05等處啟動。 |
|
時間 |
給定日期內請求發送的時間。僅當接收執行間隔設置為每日、每周或每月時適用。 |
|
天 |
發送請求應該發生的日期。僅在接收執行間隔設置為每周或每月時適用。 |
|
cron表達式 |
表示cron表達式的任意字符串，用于確定發送請求應該何時發生。僅在接收執行間隔設置為高級時適用。 |
高級
本地文件夾
確定磁盤上發送/上傳文件的文件夾以及接收/下載文件的文件夾的設置。
|
輸入文件夾（Send） |
端口可以發送/上傳放在此文件夾中的文件。如果啟用了自動發送，端口將自動輪詢處理此文件夾中的文件。 |
|
輸出文件夾（Receive） |
端口會將接收/下載的文件放在此文件夾中。如果端口連接到工作流中的另一個端口，文件將不會保留在這里，而是傳遞到已連接端口的輸入/Send文件夾。 |
|
已處理文件夾（Sent） |
處理文件后，如果啟用了保存到已發送文件夾，端口將在此文件夾中放置已發送/已上傳文件的副本。 |
SSL客戶端認證
需要雙向SSL認證時與客戶端認證相關的設置。
|
私鑰證書 |
在SSL客戶端認證期間的私鑰證書。 |
|
證書密碼 |
訪問SSL客戶端證書所需的密碼。 |
其他配置
先前類別中未包含的配置。
|
HTTP版本 |
連接到REST服務時是使用HTTP 1.0、1.1還是2.0。 |
|
超時時長 |
引發超時錯誤之前等待REST服務器響應的持續時間(秒)。 |
|
使用分塊編碼 |
發送請求時是否使用HTTP分塊傳輸編碼。這允許應用程序順序發送消息的部分(塊)，以避免連接過載。 |
|
塊大小 |
啟用“使用分塊編碼”時，每個分塊的大小(以字節為單位)。 |
|
日志級別 |
為端口生成的日志中包含的詳細程度。 |
|
日志消息 |
發送文件中的日志是否包含文件本身的副本。 |
|
保存到已發送文件夾 |
端口發送的文件是否應復制到連接器的已發送文件夾。 |
|
啟用SSL的協議 |
建立傳出連接時支持的SSL/TLS協議列表。強烈建議僅使用TLS協議。一些過時的操作系統不支持TLS 1.2。 |
建立連接
建立到任何REST服務的連接都需要有效的目標網址。服務網址可以支持各種不同的HTTP方法，方法應該根據特定的網絡服務操作或數據集進行配置以進行檢索。某些服務可能還需要身份驗證或一組自定義頭部才能使用該服務。
如果目標網址是“https”網址，則應該將SSL服務器證書設置為標識服務器的公鑰證書。此字段可以設置為“任何證書”，以隱式信任目標端點。
認證
REST端口支持基本(明文)或摘要(加密)格式的用戶名-密碼身份驗證。這些憑據作為請求中的頭部提供給REST服務。
REST端口也支持OAuth認證，但是OAuth訪問令牌和刷新令牌必須提前獲取。使用REST服務的門戶網站或開發控制臺來查找/生成適當的OAuth令牌。然后，端口處理自動刷新令牌的過程，以便一旦首次提供OAuth配置值，端口就能夠持續連接。
靜態請求
具有完全靜態內容的REST請求(例如，使用HTTP GET方法的請求)不需要輸入文件，因為請求內容完全在端口用戶界面中配置。只需在頭部部分添加任何必要的名稱-值對作為自定義頭部，或者在正文部分添加表單數據。
如果啟用了自動接收，靜態請求可以根據時間表自動發送。對每個請求的響應將存儲在輸出/Receive文件夾中，或者傳遞給流程中的下一個端口。
如果啟用了自動發送，到達端口的輸入/Send文件夾的文件也會觸發靜態請求。輸入文件的內容被忽略，請求根據用戶界面中的配置發送。
動態請求
REST請求可以動態填充來自到達端口的輸入/Send文件夾的文件的數據。
原始輸入數據
如果請求的主體類型設置為“raw”，輸入文件的內容將作為REST請求的主體發送。
可以通過content-type下拉列表設置數據的特定content-type。如果沒有列出所需的content-type，可能需要在頭部部分添加content-type頭部。
動態表單數據
如果請求的主體類型設置為“form-data”或“x-www-urlencoded”，那么端口將從輸入文件中查找特定值來填充請求。對于設置為“Dynamic”的每個主體字段，端口將掃描輸入文件中與字段名同名且遵循特定XML結構的XML元素:
-
API
+關注
關注
2文章
1511瀏覽量
62402 -
端口
+關注
關注
4文章
990瀏覽量
32211 -
REST
+關注
關注
0文章
33瀏覽量
9448 -
Restful
+關注
關注
0文章
11瀏覽量
3554
發布評論請先 登錄
相關推薦
詳解REST API通信協議
socket 與 RESTful API 的使用
Python編程：處理網絡請求的代理技術
外部端口和內部端口是什么意思
求助，關于ESP8266 HTTPClient REST調用問題求解
使用espconn api實現UPNP IGD端口轉發，為什么沒有發送ACK？
使用 Splashtop REST API 簡化遠程管理
工商網監
評論