Apifox接口測試工具

Apifox工具通過專業軟件的支持來對API各（gè）類數據進行檢測，從而得到相關的運行以及使用問題。同時還（hái）能用（yòng）它來（lái）進行建檔、新建出新的接口以及各類數據項目，為（wéi）相關人員的（de）開發工作大大提高了辦公效（xiào）率。

Apifox官方版介紹

Apifox是API文檔（dàng）、API調試（shì）、APIMock、API自動化測試一（yī）體化協作平（píng）台，定位postman+Swagger+Mock+JMeter。通過（guò）一（yī）套係統（tǒng）、一份數據，解決多個係（xì）統之間的（de）數（shù）據同（tóng）步問題。隻要定義好API文檔，API調試、API數據Mock、API自動化測試就可以直接使用，無需（xū）再次定義；API文檔和API開（kāi）發調（diào）試使用同一個工具（jù），API調（diào）試完成後即可保證和API文檔定義完全一致。高效、及（jí）時、準確！

常見問題（tí）

1.使用 Postman 調用接口返回正（zhèng）常，而 Apifox 返回錯誤

解決方法：對比 postman 和 apifox 實際發出的請求內容（url、參數、body、header）是否完全一樣。

查看實際請求內（nèi）容（róng）方法：

Postman：點擊底部狀態欄裏的Console查（chá）看。

Apifox：返回內容下的實際請求 tab (老版本為Request tab) 裏查看。

2.同項目（mù）下有不（bú）同域名的接口，如何處理？

方法一：在環（huán）境（jìng）裏新增多個服務，分別設置不同的前置 URL ,接口（kǒu）分組和接（jiē）口（kǒu）維度（dù）可以指定對應的前置（zhì） URL。推（tuī）薦本方案（àn）。

方法二：給不同域名接口設置不同環境（jìng），通過切換環境（jìng）來運行不同域名下（xià）的接口。不推薦本方案。

方法三：把（bǎ）域名設置成環境變（biàn）量如DOMAIN_1，接口路徑（jìng）這樣填寫：https:///users。接口路徑是以http://或https://起始的，係統會自動忽（hū）略裏環境裏（lǐ）前置 URL。

3.為什麽修改了（le）環境變（biàn）量（或全局（jú）變量）值，而引用的地方沒（méi）有生效？

請檢查修改的是否是本地值，環境變量（或全局變（biàn）量）僅讀取本地值，而不會讀取遠程值。

請檢查環境變量、全局變（biàn）量、臨時變量（liàng）裏是不是有多個地（dì）方定（dìng）義了相同名稱的變量，如果有，係統會根據優先（xiān）級來（lái）取值（zhí）。

優先（xiān）級順（shùn）序如下：臨時變量（liàng）>環境變量>全局變量。

軟件功能

數據模型：

可複用的數據結構，定義接口返（fǎn）回數據結構及請求參數數據結構（僅 JSON 和 XML 模式）時可直（zhí）接引用。支（zhī）持模型直接嵌套引用（yòng），直接 JSON/XML 智能導（dǎo）入，支（zhī）持 oneOf、allOf 等（děng）高級組合模式。

數據庫操作：

支持讀取數據庫數據，作為（wéi）接（jiē）口請求（qiú）參數使（shǐ）用。支持讀取數據庫（kù）數據，用來校驗(斷言)接口請求是否成功。

接（jiē）口（kǒu）自動化測試：提供接口集合測試，可以通過選擇接口（或接口用例）快速創（chuàng）建（jiàn）測試集。目前接（jiē）口自動化測試更多（duō）功能還在開發中，敬（jìng）請期待！目（mù）標是： JMeter 有的功能基本都會有（yǒu），並且要更好用（yòng）。

接口設計（jì）：

Apifox 接口文檔遵循 OpenApi 3.0 (原 Swagger)、JSON Schema 規（guī）範的同時，提供了非常好用的可視化文檔管（guǎn）理功能，零學習（xí）成本，非常高效。並且支（zhī）持在線（xiàn）分享接口文（wén）檔（dàng）。

接口用例：

通常一個接口會有多種情況用例，比如參數正確用例、參數（shù）錯誤用例、數據（jù）為空用例、不同數據狀態用例等等。運行（háng）接口用例時會自動校驗數據正確性，用接口用例（lì）來調試接口非常高效。

團隊協作：

Apifox 天生就是為團隊協作而生的，接口雲端實時同步更新（xīn），成（chéng）熟的團隊/項目/成員權（quán）限（xiàn）管理，滿足各類企業的需（xū）求。

接口調試：

Postman 有的功能，比如環境變量、前置/後置腳本（běn）、Cookie/Session 全局共享 等功能，Apifox 都（dōu）有（yǒu），並且比 Postman 更高（gāo）效好用。接口運行完之後點擊保存為用例按鈕，即可生成接口（kǒu）用例，後續（xù）可直接運行接口用例，無需再輸入（rù）參數，非常方便。自定義腳本 100% 兼容（róng） Postman 語法，並且（qiě）支持運行 javascript、java、python、php、js、BeanShell、go、shell、ruby、lua 等各種語言代碼。

接口數據 Mock：

內（nèi）置 Mock.js 規則引擎，非常方便 mock 出各種數據，並且可以在定義數（shù）據結構的同時寫好 mock 規（guī）則。支（zhī）持添加“期望”，根據請求參數返回不同 mock 數據。最重（chóng）要的是 Apifox 零配置 即可 Mock 出非常人性化（huà）的數據，具體（tǐ）在本文後麵介紹。

代碼生成：

根據接口（kǒu）及數據數據模型定義，係統自動生成（chéng）接口請求代碼、前端業務代碼（mǎ）及後（hòu）端業務代碼。

快（kuài）捷調試：

類似 Postman 的接口調試方式，主要用途為臨時調試一些無需文檔化的接口，無需提前定義接口即（jí）可（kě）快（kuài）速調試。

Apifox Windows / Linux快捷鍵

新建快捷調試（shì）：Ctrl + T

新建接口：Ctrl + N

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

發送請（qǐng）求：Ctrl + Enter

切換到【運行】Tab：Ctrl + Enter

強製關閉 Tab：Ctrl + Alt + W

關（guān）閉 Tab：Ctrl + W

導入抓包數（shù）據 (cURL)：Ctrl + I

導入數據（jù）：Ctrl + O

查找接口：Ctrl + F

切換到上一（yī）個 Tab：Ctrl + Shift + Tab 或 Ctrl + PageUp

切（qiē）換到下一個 Tab：Ctrl + Tab 或 Ctrl + PageDown

跳轉到特定標簽頁：Ctrl + 1 到 Ctrl + 8

跳（tiào）轉到最後一個標簽頁：Ctrl + 9

更新日誌

v1.4.21更新內容：

優（yōu）化：openapi 導入，示例字段 example 的優化。

新建 tab 頁打開多個情況下，關閉最初的一個後再次點擊新建沒有打開的問題。

解決多前置（zhì） URL 偶現失效的情況。