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

socket 與 RESTful API 的使用
Python編程:處理網(wǎng)絡(luò)請求的代理技術(shù)
外部端口和內(nèi)部端口是什么意思
以太網(wǎng)端口支持哪些類型的設(shè)備和連接方式
求助,關(guān)于ESP8266 HTTPClient REST調(diào)用問題求解
使用espconn api實現(xiàn)UPNP IGD端口轉(zhuǎn)發(fā),為什么沒有發(fā)送ACK?
使用PyTorch構(gòu)建神經(jīng)網(wǎng)絡(luò)
使用 Splashtop REST API 簡化遠(yuǎn)程管理

評論