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

什么是REST API？

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

如何使用REST端口？

1. 準備工作

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

1.1 http協(xié)議
1.2 URI
1.3 方法
1.4 認證
1.5 請求和響應(yīng)的數(shù)據(jù)格式

2. 配置

2.1 URL

2.2 方法

2.3 認證

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

2.4 請求和響應(yīng)數(shù)據(jù)

3. 測試

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

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

數(shù)據(jù)格式：JSON

Token認證：

根據(jù)參數(shù)列表：

整理對應(yīng)的請求內(nèi)容：

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

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

常見問題：

1. 需要自動使用GET方法獲取數(shù)據(jù)

在配置和調(diào)試完成后，在REST端口-》自動化設(shè)置頁，勾選自動化設(shè)置-》接收，并預(yù)設(shè)自動輪詢時間即可。

2. 需要使用POST方法自動獲取數(shù)據(jù)

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

總結(jié)：

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

審核編輯：符乾江