創(chuàng)建第一個(gè)API

API基本信息

進(jìn)入 API文檔 頁(yè)面，點(diǎn)擊 新建API 按鈕，進(jìn)入到 API編輯 頁(yè)面。

設(shè)置API分組

最多支持三級(jí)分組，對(duì)API進(jìn)行適當(dāng)?shù)臍w類(lèi)有助于提高管理效率。

設(shè)置API URL以及API名稱(chēng)

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

設(shè)置API狀態(tài)

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

狀態(tài)	描述
啟用	當(dāng)前API正常使用
維護(hù)	當(dāng)前API正在維護(hù)，不建議使用
棄用	當(dāng)前API已經(jīng)停用，不建議使用
待定	當(dāng)前API尚未開(kāi)發(fā)，需求待定
開(kāi)發(fā)	當(dāng)前API正在開(kāi)發(fā)
測(cè)試	當(dāng)前API正在測(cè)試
對(duì)接	當(dāng)前API正在對(duì)接調(diào)試
BUG	當(dāng)前API出現(xiàn)BUG，建議盡快修復(fù)

請(qǐng)求信息

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

設(shè)置Header

請(qǐng)求頭部中，你可以手動(dòng)輸入接口的頭部信息，也可以使用 導(dǎo)入頭部 的功能批量導(dǎo)入：

設(shè)置Request Body

Body請(qǐng)求參數(shù)提供了兩種類(lèi)型：Form-data或者Raw。您可以您可以手動(dòng)輸入請(qǐng)求參數(shù)或者使用 導(dǎo)入JSON / 導(dǎo)入XML 功能來(lái)批量導(dǎo)入請(qǐng)求參數(shù)。

同時(shí)，F(xiàn)orm-data支持記錄無(wú)限層級(jí)結(jié)構(gòu)的請(qǐng)求參數(shù)，參數(shù)層級(jí)通過(guò) “>>” 表示并且能對(duì)每個(gè)參數(shù)設(shè)定非常詳細(xì)的示例和值可能性等：

設(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ù)括起來(lái)，下方的表格中不需要使用{}。

返回參數(shù)

您可以您可以手動(dòng)輸入請(qǐng)求參數(shù)或者使用 導(dǎo)入JSON / 導(dǎo)入XML 功能來(lái)批量導(dǎo)入請(qǐng)求參數(shù)。

返回示例

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

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

API詳細(xì)文檔

當(dāng)API文檔無(wú)法詳細(xì)地記錄下您的API信息時(shí)，您可以通過(guò)使用Markdown或者富文本的方式來(lái)編寫(xiě)需要補(bǔ)充的信息：

Mock API

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