API是Application Programming Interface（應用程序接口）的縮寫，它是拿來描述一個類庫的特征或是如何去運用它。按照目前比較主流的分法，可以分為REST API和非REST API。知行之橋中的API端口主要支持對象就是REST API。

什么是REST API？

首先，REST是一種架構風格。REST API就是選擇通過使用http協議和uri，利用C/S（客戶端/服務器） 模型對資源進行增刪改查操作。而其中客戶端和服務器是分離的，而知行之橋中的REST端口就是作為REST API中的客戶端，對服務器發起操作請求的。

如何使用REST端口？

1. 準備工作

按照REST API的描述，需要確認以下信息：

1.1 http協議
1.2 URI
1.3 方法
1.4 認證
1.5 請求和響應的數據格式

2. 配置

2.1 URL

2.2 方法

2.3 認證

支持的認證類型有None,Basic,NTLM,Digest,OAuth2,Bearer,AWSSignature等。

2.4 請求和響應數據

3. 測試

本次將使用知行之橋的admin API作為示例，接口文檔可參考知行之橋頁面：api.rst 本次使用的接口目的是上傳文件到指定端口。

接口URL：http://localhost:8014/api.rsc/files/ 操作：POST

數據格式：JSON

Token認證：

根據參數列表：

整理對應的請求內容：

將請求內容保存成文件后，在REST端口的輸入頁面中上傳并發送：

將在端口Nina的輸入中生成一個文件：

常見問題：

1. 需要自動使用GET方法獲取數據

在配置和調試完成后，在REST端口-》自動化設置頁，勾選自動化設置-》接收，并預設自動輪詢時間即可。

2. 需要使用POST方法自動獲取數據

需要在REST端口前加一個script端口，用于生成需要發送的請求數據，并勾選自動化-》接收。Script端口的箭頭指向REST端口。

總結：

1.拿到REST API接口文檔；
2.按照接口文檔配置REST端口；
3.根據接口文檔中的屬性列表或測試文件整理請求數據；
4.發送請求數據，進行調試。

審核編輯：符乾江