## 一、創(chuàng)建 API 分組

企業(yè)的接口繁多，在使用 API 服務(wù)前，需要先創(chuàng)建分組，來進(jìn)行對(duì) API 的分組管理。

![](/media/202403/p1_1709711084.png)

點(diǎn)擊創(chuàng)建分組，填寫基礎(chǔ)信息

![](/media/202307/2023-07-20_171422_1835630.28434965160255365.png)

其中域名為當(dāng)前分組接口的主訪問路徑

## 二、API 服務(wù)

添加完分組后，我們點(diǎn)擊進(jìn)入到分組詳情，目前提供三種創(chuàng)建方式，創(chuàng)建單個(gè)接口、從SQL創(chuàng)建接口和創(chuàng)建路由

![](/media/202406/2024-06-12_142103_8627590.7103240864537151.png)

### 1. 創(chuàng)建 API 接口

點(diǎn)擊創(chuàng)建 API 接口，輸入基礎(chǔ)信息后可以看到目前 API 接口添加支持 3 種方式

![](/media/202406/2024-06-12_142501_0563600.10909835528896938.png)

#### 第一種：創(chuàng)建新的 API 服務(wù)流程

選擇此類方式，在 API 創(chuàng)建過程中，需要從頭開始搭建 API 接口服務(wù)流程

![](/media/202307/2023-07-20_172103_9066980.5420188085165649.png)
你需要配置請(qǐng)求參數(shù)和返回參數(shù)，在 API 接口流程中，你可以添加任意應(yīng)用進(jìn)行流程搭建，實(shí)現(xiàn)組合服務(wù)接口

#### 第二種：選擇已經(jīng)創(chuàng)建的 API 接口流程

選擇此類方式，需要提前在流程中創(chuàng)建好，并發(fā)布

![](/media/202406/2024-06-12_142655_7571270.5246526626654636.png)

選擇關(guān)聯(lián)的流程中，即可使用。
需要注意的是，選擇的關(guān)聯(lián)流程務(wù)必處于發(fā)布狀態(tài)

#### 第三種：導(dǎo)入創(chuàng)建

企業(yè)有大量的接口時(shí)，需要導(dǎo)入接口文檔進(jìn)行創(chuàng)建，目前支持導(dǎo)入 yaml、json 和 openapi 格式的文件。

![](/media/202406/2024-06-12_142741_8383470.8928828365306455.png)
導(dǎo)入文件后，系統(tǒng)將自動(dòng)生成一個(gè)流程，并配置好輸入和輸出參數(shù)，你需要調(diào)整和配置 http 請(qǐng)求，進(jìn)行試運(yùn)行后并發(fā)布

![](/media/202307/2023-07-20_174115_1769400.7388308700036227.png)

### 2. 創(chuàng)建 路由

點(diǎn)擊創(chuàng)建路由，根據(jù)提示輸入基礎(chǔ)信息，需要綁定一個(gè)上游服務(wù)（即后端服務(wù)），可以對(duì)上游服務(wù)的多個(gè)目標(biāo)節(jié)點(diǎn)進(jìn)行負(fù)載均衡和健康檢查。

![](/media/202403/p3_1709714493.png)

![](/media/202403/p4_1709714230.png)

### 3.從SQL創(chuàng)建接口

點(diǎn)擊從SQL創(chuàng)建接口，根據(jù)提示輸入基礎(chǔ)信息，選擇應(yīng)用后，需選擇相應(yīng)的賬號(hào)，信息填好后可以點(diǎn)擊測(cè)試預(yù)覽查看字段預(yù)覽。

![](/media/202406/2024-06-12_143020_6292760.02642887801244853.png)

### 4.API 調(diào)試與查看

配置完成之后，在列表里可以看到該組下所有接口和路由的狀態(tài)，可以點(diǎn)擊列表右側(cè)的更多按鈕打開調(diào)試器，輸入?yún)?shù)即可查看接口服務(wù)是否正常

![](/media/202403/p5_1709714604.png)

![](/media/202307/2023-07-20_173059_5271540.7088841399264354.png)

API服務(wù)