創(chuàng)建API

API基本信息

進入 API文檔 頁面，點擊 新建API 按鈕，進入到 API編輯 頁面。

設置API分組

最多支持三級分組，對API進行適當?shù)臍w類有助于提高管理效率。

設置API URL以及API名稱

如果您有多個項目環(huán)境，不同的項目環(huán)境擁有不同的請求URL前綴，那么URL僅需要填寫API的路徑即可（如/user/login），切換不同的URL前綴可以使用eoLinker AMS中的環(huán)境管理功能。相關教程請前往 API開發(fā)管理 > 公共資源管理 > 環(huán)境管理 一節(jié)。

設置API狀態(tài)

在eoLinker AMS中，API擁有以下的幾種狀態(tài)：

請求信息

在API文檔中，您可以記錄Header、Request Body、REST Params、Query/GET Params、鑒權等信息。

設置Header

請求頭部中，你可以手動輸入接口的頭部信息，也可以使用 導入頭部 的功能批量導入：

設置Request Body

Body請求參數(shù)提供了兩種類型：Form-data或者Raw。您可以您可以手動輸入請求參數(shù)或者使用 導入JSON / 導入XML 功能來批量導入請求參數(shù)。

同時，F(xiàn)orm-data支持記錄無限層級結(jié)構的請求參數(shù)，參數(shù)層級通過 “>>” 表示并且能對每個參數(shù)設定非常詳細的示例和值可能性等：

設置REST Params

在eoLinker AMS中，REST參數(shù)在URL中使用 {param_name} 表示，如 /user/login/{user_name}/{user_type}，該API擁有REST參數(shù)user_name和user_type。

注意，您只需要在URL中使用{}將REST參數(shù)括起來，下方的表格中不需要使用{}。

返回參數(shù)

您可以您可以手動輸入請求參數(shù)或者使用 導入JSON / 導入XML 功能來批量導入請求參數(shù)。

返回示例

您可以記錄API請求成功或失敗的示例，eoLinker AMS提供了API來獲取編寫好的API返回示例，可以用于前端開發(fā)人員測試API。

保存API文檔之后，通過返回示例API即可獲得事先編寫好的返回示例：

API詳細文檔

當API文檔無法詳細地記錄下您的API信息時，您可以通過使用Markdown或者富文本的方式來編寫需要補充的信息：

Mock API

如需了解如何設置Mock API的生成規(guī)則，請移步至 API開發(fā)管理 > Mock API > 設置MockAPI 一節(jié)中查看。