REST端口支持構(gòu)建動(dòng)態(tài)REST請(qǐng)求來(lái)使用RESTful API網(wǎng)絡(luò)服務(wù)。

概覽

REST端口暴露了一個(gè)簡(jiǎn)單的接口來(lái)為REST請(qǐng)求構(gòu)建頭、授權(quán)、主體和HTTP方法。請(qǐng)求體可以在端口配置中靜態(tài)設(shè)置，也可以根據(jù)端口處理的文件動(dòng)態(tài)生成。

端口配置

配置

與端口核心操作相關(guān)的配置。

認(rèn)證

頭部

頭部部分支持添加任意列表的HTTP頭部，以包含在傳出的REST請(qǐng)求中。頭部被指定為名稱-值對(duì)。當(dāng)主體類型設(shè)置為Raw時(shí)，此部分可用于指定消息主體的Content-Type。

消息主體

與生成REST請(qǐng)求主體相關(guān)的設(shè)置。當(dāng)HTTP方法設(shè)置為“GET”時(shí)不適用。

SSL服務(wù)器認(rèn)證

與SSL服務(wù)器認(rèn)證相關(guān)的設(shè)置。

自動(dòng)

與端口自動(dòng)處理文件有關(guān)的設(shè)置。

高級(jí)

本地文件夾

確定磁盤(pán)上發(fā)送/上傳文件的文件夾以及接收/下載文件的文件夾的設(shè)置。

SSL客戶端認(rèn)證

需要雙向SSL認(rèn)證時(shí)與客戶端認(rèn)證相關(guān)的設(shè)置。

其他配置

先前類別中未包含的配置。

建立連接

建立到任何REST服務(wù)的連接都需要有效的目標(biāo)網(wǎng)址。服務(wù)網(wǎng)址可以支持各種不同的HTTP方法，方法應(yīng)該根據(jù)特定的網(wǎng)絡(luò)服務(wù)操作或數(shù)據(jù)集進(jìn)行配置以進(jìn)行檢索。某些服務(wù)可能還需要身份驗(yàn)證或一組自定義頭部才能使用該服務(wù)。

如果目標(biāo)網(wǎng)址是“https”網(wǎng)址，則應(yīng)該將SSL服務(wù)器證書(shū)設(shè)置為標(biāo)識(shí)服務(wù)器的公鑰證書(shū)。此字段可以設(shè)置為“任何證書(shū)”，以隱式信任目標(biāo)端點(diǎn)。

認(rèn)證

REST端口支持基本(明文)或摘要(加密)格式的用戶名-密碼身份驗(yàn)證。這些憑據(jù)作為請(qǐng)求中的頭部提供給REST服務(wù)。

REST端口也支持OAuth認(rèn)證，但是OAuth訪問(wèn)令牌和刷新令牌必須提前獲取。使用REST服務(wù)的門(mén)戶網(wǎng)站或開(kāi)發(fā)控制臺(tái)來(lái)查找/生成適當(dāng)?shù)腛Auth令牌。然后，端口處理自動(dòng)刷新令牌的過(guò)程，以便一旦首次提供OAuth配置值，端口就能夠持續(xù)連接。

靜態(tài)請(qǐng)求

具有完全靜態(tài)內(nèi)容的REST請(qǐng)求(例如，使用HTTP GET方法的請(qǐng)求)不需要輸入文件，因?yàn)檎?qǐng)求內(nèi)容完全在端口用戶界面中配置。只需在頭部部分添加任何必要的名稱-值對(duì)作為自定義頭部，或者在正文部分添加表單數(shù)據(jù)。

如果啟用了自動(dòng)接收，靜態(tài)請(qǐng)求可以根據(jù)時(shí)間表自動(dòng)發(fā)送。對(duì)每個(gè)請(qǐng)求的響應(yīng)將存儲(chǔ)在輸出/Receive文件夾中，或者傳遞給流程中的下一個(gè)端口。

如果啟用了自動(dòng)發(fā)送，到達(dá)端口的輸入/Send文件夾的文件也會(huì)觸發(fā)靜態(tài)請(qǐng)求。輸入文件的內(nèi)容被忽略，請(qǐng)求根據(jù)用戶界面中的配置發(fā)送。

動(dòng)態(tài)請(qǐng)求

REST請(qǐng)求可以動(dòng)態(tài)填充來(lái)自到達(dá)端口的輸入/Send文件夾的文件的數(shù)據(jù)。

原始輸入數(shù)據(jù)

如果請(qǐng)求的主體類型設(shè)置為“raw”，輸入文件的內(nèi)容將作為REST請(qǐng)求的主體發(fā)送。

可以通過(guò)content-type下拉列表設(shè)置數(shù)據(jù)的特定content-type。如果沒(méi)有列出所需的content-type，可能需要在頭部部分添加content-type頭部。

動(dòng)態(tài)表單數(shù)據(jù)

如果請(qǐng)求的主體類型設(shè)置為“form-data”或“x-www-urlencoded”，那么端口將從輸入文件中查找特定值來(lái)填充請(qǐng)求。對(duì)于設(shè)置為“Dynamic”的每個(gè)主體字段，端口將掃描輸入文件中與字段名同名且遵循特定XML結(jié)構(gòu)的XML元素: