Apifox工具通過(guò)專(zhuān)業(yè)軟件的支持來(lái)對(duì)API各類(lèi)數(shù)據(jù)進(jìn)行檢測(cè)，從而得到相關(guān)的運(yùn)行以及使用問(wèn)題。同時(shí)還能用它來(lái)進(jìn)行建檔、新建出新的接口以及各類(lèi)數(shù)據(jù)項(xiàng)目，為相關(guān)人員的開(kāi)發(fā)工作大大提高了辦公效率。

Apifox官方版介紹

Apifox是API文檔、API調(diào)試、APIMock、API自動(dòng)化測(cè)試一體化協(xié)作平臺(tái)，定位postman+Swagger+Mock+JMeter。通過(guò)一套系統(tǒng)、一份數(shù)據(jù)，解決多個(gè)系統(tǒng)之間的數(shù)據(jù)同步問(wèn)題。只要定義好API文檔，API調(diào)試、API數(shù)據(jù)Mock、API自動(dòng)化測(cè)試就可以直接使用，無(wú)需再次定義；API文檔和API開(kāi)發(fā)調(diào)試使用同一個(gè)工具，API調(diào)試完成后即可保證和API文檔定義完全一致。高效、及時(shí)、準(zhǔn)確！

常見(jiàn)問(wèn)題

1.使用 Postman 調(diào)用接口返回正常，而 Apifox 返回錯(cuò)誤

解決方法：對(duì)比 postman 和 apifox 實(shí)際發(fā)出的請(qǐng)求內(nèi)容（url、參數(shù)、body、header）是否完全一樣。

查看實(shí)際請(qǐng)求內(nèi)容方法：

Postman：點(diǎn)擊底部狀態(tài)欄里的Console查看。

Apifox：返回內(nèi)容下的實(shí)際請(qǐng)求 tab (老版本為Request tab) 里查看。

2.同項(xiàng)目下有不同域名的接口，如何處理？

方法一：在環(huán)境里新增多個(gè)服務(wù)，分別設(shè)置不同的前置 URL ,接口分組和接口維度可以指定對(duì)應(yīng)的前置 URL。推薦本方案。

方法二：給不同域名接口設(shè)置不同環(huán)境，通過(guò)切換環(huán)境來(lái)運(yùn)行不同域名下的接口。不推薦本方案。

方法三：把域名設(shè)置成環(huán)境變量如DOMAIN_1，接口路徑這樣填寫(xiě)：https:///users。接口路徑是以http://或https://起始的，系統(tǒng)會(huì)自動(dòng)忽略里環(huán)境里前置 URL。

3.為什么修改了環(huán)境變量（或全局變量）值，而引用的地方?jīng)]有生效？

請(qǐng)檢查修改的是否是本地值，環(huán)境變量（或全局變量）僅讀取本地值，而不會(huì)讀取遠(yuǎn)程值。

請(qǐng)檢查環(huán)境變量、全局變量、臨時(shí)變量里是不是有多個(gè)地方定義了相同名稱(chēng)的變量，如果有，系統(tǒng)會(huì)根據(jù)優(yōu)先級(jí)來(lái)取值。

優(yōu)先級(jí)順序如下：臨時(shí)變量>環(huán)境變量>全局變量。

軟件功能

數(shù)據(jù)模型：

可復(fù)用的數(shù)據(jù)結(jié)構(gòu)，定義接口返回?cái)?shù)據(jù)結(jié)構(gòu)及請(qǐng)求參數(shù)數(shù)據(jù)結(jié)構(gòu)（僅 JSON 和 XML 模式）時(shí)可直接引用。支持模型直接嵌套引用，直接 JSON/XML 智能導(dǎo)入，支持 oneOf、allOf 等高級(jí)組合模式。

數(shù)據(jù)庫(kù)操作：

支持讀取數(shù)據(jù)庫(kù)數(shù)據(jù)，作為接口請(qǐng)求參數(shù)使用。支持讀取數(shù)據(jù)庫(kù)數(shù)據(jù)，用來(lái)校驗(yàn)(斷言)接口請(qǐng)求是否成功。

接口自動(dòng)化測(cè)試：提供接口集合測(cè)試，可以通過(guò)選擇接口（或接口用例）快速創(chuàng)建測(cè)試集。目前接口自動(dòng)化測(cè)試更多功能還在開(kāi)發(fā)中，敬請(qǐng)期待！目標(biāo)是： JMeter 有的功能基本都會(huì)有，并且要更好用。

接口設(shè)計(jì)：

Apifox 接口文檔遵循 OpenApi 3.0 (原 Swagger)、JSON Schema 規(guī)范的同時(shí)，提供了非常好用的可視化文檔管理功能，零學(xué)習(xí)成本，非常高效。并且支持在線分享接口文檔。

接口用例：

通常一個(gè)接口會(huì)有多種情況用例，比如參數(shù)正確用例、參數(shù)錯(cuò)誤用例、數(shù)據(jù)為空用例、不同數(shù)據(jù)狀態(tài)用例等等。運(yùn)行接口用例時(shí)會(huì)自動(dòng)校驗(yàn)數(shù)據(jù)正確性，用接口用例來(lái)調(diào)試接口非常高效。

團(tuán)隊(duì)協(xié)作：

Apifox 天生就是為團(tuán)隊(duì)協(xié)作而生的，接口云端實(shí)時(shí)同步更新，成熟的團(tuán)隊(duì)/項(xiàng)目/成員權(quán)限管理，滿(mǎn)足各類(lèi)企業(yè)的需求。

接口調(diào)試：

Postman 有的功能，比如環(huán)境變量、前置/后置腳本、Cookie/Session 全局共享 等功能，Apifox 都有，并且比 Postman 更高效好用。接口運(yùn)行完之后點(diǎn)擊保存為用例按鈕，即可生成接口用例，后續(xù)可直接運(yùn)行接口用例，無(wú)需再輸入?yún)?shù)，非常方便。自定義腳本 100% 兼容 Postman 語(yǔ)法，并且支持運(yùn)行 javascript、java、python、php、js、BeanShell、go、shell、ruby、lua 等各種語(yǔ)言代碼。

接口數(shù)據(jù) Mock：

內(nèi)置 Mock.js 規(guī)則引擎，非常方便 mock 出各種數(shù)據(jù)，并且可以在定義數(shù)據(jù)結(jié)構(gòu)的同時(shí)寫(xiě)好 mock 規(guī)則。支持添加“期望”，根據(jù)請(qǐng)求參數(shù)返回不同 mock 數(shù)據(jù)。最重要的是 Apifox 零配置 即可 Mock 出非常人性化的數(shù)據(jù)，具體在本文后面介紹。

代碼生成：

根據(jù)接口及數(shù)據(jù)數(shù)據(jù)模型定義，系統(tǒng)自動(dòng)生成接口請(qǐng)求代碼、前端業(yè)務(wù)代碼及后端業(yè)務(wù)代碼。

快捷調(diào)試：

類(lèi)似 Postman 的接口調(diào)試方式，主要用途為臨時(shí)調(diào)試一些無(wú)需文檔化的接口，無(wú)需提前定義接口即可快速調(diào)試。

Apifox Windows / Linux快捷鍵

新建快捷調(diào)試：Ctrl + T

新建接口：Ctrl + N

保存接口 / 保存用例：Ctrl + S

發(fā)送請(qǐng)求：Ctrl + Enter

切換到【運(yùn)行】Tab：Ctrl + Enter

強(qiáng)制關(guān)閉 Tab：Ctrl + Alt + W

關(guān)閉 Tab：Ctrl + W

導(dǎo)入抓包數(shù)據(jù) (cURL)：Ctrl + I

導(dǎo)入數(shù)據(jù)：Ctrl + O

查找接口：Ctrl + F

切換到上一個(gè) Tab：Ctrl + Shift + Tab 或 Ctrl + PageUp

切換到下一個(gè) Tab：Ctrl + Tab 或 Ctrl + PageDown

跳轉(zhuǎn)到特定標(biāo)簽頁(yè)：Ctrl + 1 到 Ctrl + 8

跳轉(zhuǎn)到最后一個(gè)標(biāo)簽頁(yè)：Ctrl + 9

更新日志

v1.4.21更新內(nèi)容：

優(yōu)化：openapi 導(dǎo)入，示例字段 example 的優(yōu)化。

新建 tab 頁(yè)打開(kāi)多個(gè)情況下，關(guān)閉最初的一個(gè)后再次點(diǎn)擊新建沒(méi)有打開(kāi)的問(wèn)題。

解決多前置 URL 偶現(xiàn)失效的情況。