Apifox中文版

在這個軟件開發日益復雜的時代，API 調試和文檔編寫的需求越來越強烈，而 Apifox 正是應運而生，成為開發者們的秘密武器。作為一款全能的 API 工具，Apifox 不僅僅是一個 API 調試工具，更是集合了接口文檔生成、接口 Mock、接口管理、團隊協作等多種功能的綜合性工具。它的出現，打破了傳統開發流程中的效率瓶頸，幫助開發者和團隊更高效地進行 API 測試和協作。

Apifox更新日志

v2.6.30版本

新功能：發布文檔 時可以發布多個站點，每個站點可以選擇部分接口發布

解決使用腳本操作全局 Cookie 時，界面會一直顯示加載中的問題

解決導出定時運行的自動化測試的測試報告時，未包含詳情的問題

解決導入 Swagger/OpenAPI 格式的數據時，沒有正確導入 Apifox 擴展的 x-apifox-maintainer 責任人字段的問題

v2.6.8版本

【新功能】調試接口、用例時，切換文檔定義的 返回響應 后，會立即重新 校驗響應，無需重新發送請求

【優化】在 組織 的團隊管理頁面，可以將個人團隊 移動 到組織內

【優化】在 組織 的成員管理頁面，可以通過鏈接或郵箱 邀請 別人加入組織

【優化】在團隊的訂單管理頁面，可以查看 定時任務 的用量

【優化】定時導入 接口數據，支持立即運行通過自托管 Runner 執行的導入任務

【優化】定時導入 接口數據，導入頻率最短可以配置為每隔 5 分鐘

【優化】導入 Swagger/OpenAPI 文件時，可以配置當 summary 為空時，優先使用 operationId、path 作為接口名，還是優先從 descrption 中提取接口名

【優化】當引用的 測試場景 被 Fork 到子分支時，會使用子分支的資源來運行

【優化】Markdown 文檔的大綱內的英文單詞，不再會被截斷

解決點擊測試報告列表頁的“去看看”鏈接時，某些情況下沒有打開測試報告的問題

解決配置項目成員的自定義權限時，沒有正確展示成員昵稱的問題

Apifox注意事項

維護不同工具之間數據一致性非常困難、非常低效。并且這里不僅僅是工作量的問題，更大的問題是多個系統之間數據不一致，導致協作低效，頻繁出問題，開發人員痛苦不堪。

開發人員在 Swagger 定義好文檔后，接口調試的時候還需要去 Postman 再定義一遍。

前端開發 Mock 數據的時候又要去 RAP 定義一遍，手動設置好 Mock 規則。

測試人員需要去 JMeter 定義一遍。

前端根據 RAP Mock 出來的數據開發完，后端根據 Swagger 定義的接口文檔開發完，各自測試測試通過了，本以為可以馬上上線，結果一對接發現各種問題：原來開發過程中接口變更，只修改了 Swagger，但是沒有及時同步修改 RAP。

同樣，測試在 JMeter 寫好的測試用例，真正運行的時候也會發現各種不一致。

時間久了，各種不一致會越來越嚴重。

Apifox免費版導入數據方法

打開項目設置面板，點擊導入/導出即可使用導入數據功能。

一、導入 OpenAPI (Swagger) 數據

支持導入 OpenAPI 3、Swagger 1、2、3數據格式的json或yaml文件。

注意：

需要URL導入的時候，需要填寫的是json或yaml數據文件的 URL，而不是Swagger UI的 URL。

二、導入 Postman 數據

支持 Postman Collection v2.1 格式。

數據導出方法：找到 Postman 左側列表 Collections，鼠標移到需要導出的集合，點擊···，選擇Export然后選擇Collection v2.1 (recommended)即可導出，如下圖所示：

三、導入 ShowDoc 格式數據

將從 ShowDoc 導出的Markdown 壓縮包解壓，會看到一個文件名為prefix_info.json的 json 文件。

導入 Apifox 的時候，選擇ShowDoc格式，然后導入前面解壓得到的prefix_info.json文件即可。

四、導入 Eolinker 數據

支持Eolinker 項目數據 (.json)格式。

Eolinker 數據導出方法：打開 Eolinker 里對應項目，點擊左側菜單項目設置，在項目 Tab 里點擊導出項目，選擇Eolinker 項目數據 (.json)，然后導出，如下圖所示：

五、導入 ApiPost 數據

支持 ApiPost HTML 格式數據格式.

數據導出方法：打開 ApiPost，點擊左側導航項目，選擇對應項目，點擊右側分享項目文檔，在瀏覽器打開分享鏈接，在打開的網頁里，找到右上角離線導出，選擇導出HTML，然后導出，如下圖所示：

六、導入 DOCWAY 數據

支持 DOCWAY 復制分享地址的方式導入數據。

使用方法：打開 DOCWAY，進入對應項目，鼠標移到左上角更多功能點擊分享項目(注意僅項目創建者有權限分享項目)，創建分享 (注意“閱讀密碼”必須設置為空)，然后復制分享地址將地址黏貼到下面輸入框。如下圖所示：

Apifox軟件快捷鍵

新建快捷調試：Ctrl + T

新建接口：Ctrl + N

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

發送請求：Ctrl + Enter

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

強制關閉 Tab：Ctrl + Alt + W

關閉 Tab：Ctrl + W

導入抓包數據 (cURL)：Ctrl + I

導入數據：Ctrl + O

查找接口：Ctrl + F

切換到上一個 Tab：Ctrl + Shift + Tab 或 Ctrl + PageUp

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

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

跳轉到最后一個標簽頁：Ctrl + 9

???????

Apifox軟件功能

一、一站式接口協作平臺

Apifox = Postman + Swagger + Mock + JMeter

一套系統、一份數據，解決多個 API 工具之間的數據同步問題

只要定義好 API 文檔，API 調試、API Mock、API 自動化測試即可直接使用，無需再次定義。

API 文檔和 API 開發調試使用同一個工具，API 調試完成后即可保證和 API 文檔定義完全一致。

二、接口設計所見即所得

Apifox 接口文檔遵循 OpenAPI 3.0 (原 Swagger)、JSON Schema 規范的同時，提供了非常好用的可視化文檔管理功能，零學習成本，非常高效。并且支持在線分享接口文檔。同一個接口通常會有多種情況，比如正確用例、參數錯誤用例、數據為空用例、不同數據狀態用例。設計接口時支持定義各個接口的狀態。

三、一次請求，重復調用

無需提前定義接口即可快速調試。支持設置環境變量、前置/后置腳本、Cookie/Session 全局共享等功能。接口運行調試完成后支持一鍵保存，后續無需輸入參數即可重復運行接口用例，十分便利。

四、自動生成代碼

根據接口模型定義，自動生成各種語言/框架(如 TypeScript、Java、Go、Swift、ObjectiveC、Kotlin、Dart、C++、C#、Rust 等)的業務代碼(如 Model、Controller、單元測試代碼等)和接口請求代碼。目前 Apifox 支持 130 種語言及框架的代碼自動生成。

更重要的是：你可以通過自定義代碼模板來生成符合自己團隊的架構規范的代碼，滿足各種個性化的需求。

自定義腳本支持運行 javascript、java、python、php、js、BeanShell、go、shell、ruby、lua 等各種語言代碼。

五、智能化接口管理

使用 Apifox 調試接口的時候，系統會根據接口文檔里的定義，自動校驗返回的數據結構是否正確。不再需要通過肉眼識別，也無需手動寫斷言腳本檢測。運行接口用例時會自動校驗數據正確性，提升調試效率。根據接口及數據數據模型定義，系統還能夠自動生成接口請求代碼、前端業務代碼及后端業務代碼。

六、豐富的實用能力

1、接口數據 Mock：

內置 Mock.js 規則引擎，非常方便 Mock 出各種數據，并且可以在定義數據結構的同時寫好 mock 規則。支持添加“期望”，根據請求參數返回不同 mock 數據。最重要的是 Apifox 零配置 即可 Mock 出非常人性化的數據。

2、Apifox 如何做到高效率、零配置生成非常人性化的 mock 數據

- Apifox 根據接口定義里的數據結構、數據類型，自動生成 mock 規則。

- Apifox 內置智能 mock 規則庫，根據字段名、字段數據類型，智能優化自動生成的 mock 規則。如：名稱包含字符串image的string類型字段，自動 mock 出一個圖片地址 URL;包含字符串time的string類型字段，自動 mock 出一個時間字符串;包含字符串city的string類型字段，自動 mock 出一個城市名。

- Apifox 根據內置規則，可自動識別出圖片、頭像、用戶名、手機號、網址、日期、時間、時間戳、郵箱、省份、城市、地址、IP 等字段，從而 Mock 出非常人性化的數據。

- 除了內置 mock 規則，用戶還可以自定義規則庫，滿足各種個性化需求。支持使用 正則表達式、通配符 來匹配字段名自定義 mock 規則。

3、數據庫操作：

支持讀取數據庫數據，作為接口請求參數使用。支持讀取數據庫數據，用來校驗(斷言)接口請求是否成功。

4、接口自動化測試：

提供接口集合測試，可以通過選擇接口(或接口用例)快速創建測試集。

七、云端團隊協作

接口信息云端實時同步更新，天生響應團隊協作。成熟的團隊/項目/成員權限管理系統滿足各類企業的需求。數據模型之間支持相互引用，同樣的數據結構，只需要定義一次即可多處使用;修改時僅需修改一處，多處實時更新。

八 、兼容多種數據格式

1、支持導出 OpenApi (Swagger)、Markdown、Html 等數據格式，因為可以導出OpenApi格式數據，所以你可以利用 OpenApi (Swagger) 豐富的生態工具完成各種接口相關的事情。

2、支持導入 OpenApi (Swagger)、Postman、apiDoc、HAR、RAML、RAP2、YApi、Eolinker、NEI、DOClever、ApiPost 、Apizza 、ShowDoc、API Blueprint、I/O Docs、WADL、Google Discovery等數據格式，方便舊項目遷移。

3、支持定時自動導入OpenApi (Swagger)、apiDoc、Apifox格式數據。