Apifox接口測（cè）試工具

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

Apifox官方（fāng）版介（jiè）紹

Apifox是API文檔、API調試、APIMock、API自動化測試一體化協作平台，定位postman+Swagger+Mock+JMeter。通過一套係（xì）統、一份數據，解（jiě）決（jué）多（duō）個係統（tǒng）之間的數據同步問（wèn）題（tí）。隻要定（dìng）義好API文檔，API調試、API數據（jù）Mock、API自動化測試就可（kě）以直接使用，無需再次（cì）定義；API文檔和（hé）API開發調試使用同一個工具，API調試完成後即可保證和API文檔定義完全一致（zhì）。高效、及時、準確！

常見（jiàn）問題

1.使用 Postman 調用接口返（fǎn）回正常，而 Apifox 返回錯誤

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

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

Postman：點（diǎn）擊底部狀態（tài）欄裏的Console查看。

Apifox：返（fǎn）回內容（róng）下（xià）的實（shí）際請求 tab (老版本為Request tab) 裏查（chá）看（kàn）。

2.同項（xiàng）目下有不（bú）同（tóng）域名的接口，如何（hé）處理？

方法一：在環境裏新增多個服務，分別設置不同的前置 URL ,接（jiē）口分組和（hé）接口維度可以指（zhǐ）定對應的前置（zhì） URL。推薦本方（fāng）案。

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

方法三：把域名設（shè）置成環境變量（liàng）如DOMAIN_1，接口路徑這（zhè）樣填寫（xiě）：https:///users。接口路徑是以http://或https://起（qǐ）始的，係統會自動（dòng）忽略裏環境裏前置 URL。

3.為什（shí）麽修改了環境變量（或全局變量）值，而（ér）引用的地方沒有生效（xiào）？

請檢查修（xiū）改的是否（fǒu）是本地值，環境變量（或全局變（biàn）量）僅讀取本地值，而不（bú）會讀取遠（yuǎn）程（chéng）值。

請檢查環境（jìng）變量、全局變量、臨（lín）時變量裏是（shì）不是有多（duō）個地方定義了（le）相同名稱的（de）變量，如果有，係（xì）統會根據（jù）優先（xiān）級（jí）來取（qǔ）值。

優先級順序如（rú）下：臨時變（biàn）量>環（huán）境變量>全局變量。

軟件（jiàn）功能（néng）

數據模型（xíng）：

可複用的數據（jù）結構，定義接口返回數據結構（gòu）及請求參數數據結構（gòu）（僅（jǐn） JSON 和 XML 模式）時（shí）可直接引用（yòng）。支持（chí）模型直接嵌（qiàn）套引用，直接 JSON/XML 智能導入，支持（chí） oneOf、allOf 等高（gāo）級（jí）組合模式。

數據庫操作：

支持讀取數據（jù）庫（kù）數據，作為接口請求參（cān）數（shù）使用。支持（chí）讀取數據庫數據，用來校驗(斷言)接口請求是（shì）否成功。

接（jiē）口自動化測試：提（tí）供接口集合測試，可以通過選擇接口（或接口用例）快（kuài）速創建（jiàn）測（cè）試集。目前接口自（zì）動化（huà）測試更多功能還（hái）在開發中，敬請期待！目標是： JMeter 有的（de）功能基（jī）本（běn）都會有，並且（qiě）要更好用。

接口設計：

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

接口用例：

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

團（tuán）隊協作（zuò）：

Apifox 天（tiān）生（shēng）就是為（wéi）團（tuán）隊協作而生的，接口雲端（duān）實（shí）時同步更新，成熟的（de）團（tuán）隊/項（xiàng）目/成員權限管理，滿足各類企業的（de）需求。

接口調試：

Postman 有（yǒu）的功能，比如環（huán）境變量、前（qián）置（zhì）/後置腳（jiǎo）本、Cookie/Session 全局共享 等功能（néng），Apifox 都有，並且比（bǐ） Postman 更高效（xiào）好用（yòng）。接口運行完之後（hòu）點擊保（bǎo）存為用例（lì）按（àn）鈕，即可生（shēng）成接口用例，後續可直接運行接口用（yòng）例，無需再輸入參（cān）數，非（fēi）常方便。自定義腳本 100% 兼容 Postman 語法，並且支（zhī）持（chí）運行（háng） javascript、java、python、php、js、BeanShell、go、shell、ruby、lua 等（děng）各種（zhǒng）語言代碼。

接口（kǒu）數據 Mock：

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

代碼（mǎ）生成（chéng）：

根據接口及數據數據模（mó）型定義（yì），係統自（zì）動生成接口請求代碼、前端業務代碼及（jí）後端業務代碼。

快捷調試：

類似（sì） Postman 的接口（kǒu）調試（shì）方式，主要用途為臨時調試一（yī）些無（wú）需文檔（dàng）化的（de）接口，無需（xū）提前定義接口即（jí）可快速調試（shì）。

Apifox Windows / Linux快（kuài）捷鍵

新建快捷調試：Ctrl + T

新建接口（kǒu）：Ctrl + N

保存接口 / 保（bǎo）存用例：Ctrl + S

發送請求：Ctrl + Enter

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

強製關閉 Tab：Ctrl + Alt + W

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

導入抓包（bāo）數據 (cURL)：Ctrl + I

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

查找接口：Ctrl + F

切換（huàn）到上一個 Tab：Ctrl + Shift + Tab 或 Ctrl + PageUp

切換到下一個 Tab：Ctrl + Tab 或 Ctrl + PageDown

跳轉到特（tè）定標簽頁：Ctrl + 1 到 Ctrl + 8

跳轉到最後（hòu）一個標簽頁：Ctrl + 9

更（gèng）新日（rì）誌（zhì）

v1.4.21更新內（nèi）容：

優化：openapi 導入，示例字段 example 的優化。

新建（jiàn） tab 頁打開多個情（qíng）況下，關閉最初的一個後再次點擊新建沒有打開的問題。

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