Apifox中文版

解決點(diǎn)擊測(cè)試報(bào)告列表頁(yè)的“去看看”鏈接時(shí)，某些情況下沒有打開測(cè)試報(bào)告的問題

解決配置項(xiàng)目成員的自定義權(quán)限時(shí)，沒有正確展示成員昵稱的問題

Apifox注意事項(xiàng)

維護(hù)不同工具之間數(shù)據(jù)一致性非常困難、非常低效。并且這里不僅僅是工作量的問題，更大的問題是多個(gè)系統(tǒng)之間數(shù)據(jù)不一致，導(dǎo)致協(xié)作低效，頻繁出問題，開發(fā)人員痛苦不堪。

開發(fā)人員在 Swagger 定義好文檔后，接口調(diào)試的時(shí)候還需要去 Postman 再定義一遍。

前端開發(fā) Mock 數(shù)據(jù)的時(shí)候又要去 RAP 定義一遍，手動(dòng)設(shè)置好 Mock 規(guī)則。

測(cè)試人員需要去 JMeter 定義一遍。

前端根據(jù) RAP Mock 出來的數(shù)據(jù)開發(fā)完，后端根據(jù) Swagger 定義的接口文檔開發(fā)完，各自測(cè)試測(cè)試通過了，本以為可以馬上上線，結(jié)果一對(duì)接發(fā)現(xiàn)各種問題：原來開發(fā)過程中接口變更，只修改了 Swagger，但是沒有及時(shí)同步修改 RAP。

同樣，測(cè)試在 JMeter 寫好的測(cè)試用例，真正運(yùn)行的時(shí)候也會(huì)發(fā)現(xiàn)各種不一致。

時(shí)間久了，各種不一致會(huì)越來越嚴(yán)重。

Apifox免費(fèi)版導(dǎo)入數(shù)據(jù)方法

打開項(xiàng)目設(shè)置面板，點(diǎn)擊導(dǎo)入/導(dǎo)出即可使用導(dǎo)入數(shù)據(jù)功能。

一、導(dǎo)入 OpenAPI (Swagger) 數(shù)據(jù)

支持導(dǎo)入 OpenAPI 3、Swagger 1、2、3數(shù)據(jù)格式的json或yaml文件。

注意：

需要URL導(dǎo)入的時(shí)候，需要填寫的是json或yaml數(shù)據(jù)文件的 URL，而不是Swagger UI的 URL。

二、導(dǎo)入 Postman 數(shù)據(jù)

支持 Postman Collection v2.1 格式。

數(shù)據(jù)導(dǎo)出方法：找到 Postman 左側(cè)列表 Collections，鼠標(biāo)移到需要導(dǎo)出的集合，點(diǎn)擊···，選擇Export然后選擇Collection v2.1 (recommended)即可導(dǎo)出，如下圖所示：

三、導(dǎo)入 ShowDoc 格式數(shù)據(jù)

將從 ShowDoc 導(dǎo)出的Markdown 壓縮包解壓，會(huì)看到一個(gè)文件名為prefix_info.json的 json 文件。

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

四、導(dǎo)入 Eolinker 數(shù)據(jù)

支持Eolinker 項(xiàng)目數(shù)據(jù) (.json)格式。

Eolinker 數(shù)據(jù)導(dǎo)出方法：打開 Eolinker 里對(duì)應(yīng)項(xiàng)目，點(diǎn)擊左側(cè)菜單項(xiàng)目設(shè)置，在項(xiàng)目 Tab 里點(diǎn)擊導(dǎo)出項(xiàng)目，選擇Eolinker 項(xiàng)目數(shù)據(jù) (.json)，然后導(dǎo)出，如下圖所示：

五、導(dǎo)入 ApiPost 數(shù)據(jù)

支持 ApiPost HTML 格式數(shù)據(jù)格式.

數(shù)據(jù)導(dǎo)出方法：打開 ApiPost，點(diǎn)擊左側(cè)導(dǎo)航項(xiàng)目，選擇對(duì)應(yīng)項(xiàng)目，點(diǎn)擊右側(cè)分享項(xiàng)目文檔，在瀏覽器打開分享鏈接，在打開的網(wǎng)頁(yè)里，找到右上角離線導(dǎo)出，選擇導(dǎo)出HTML，然后導(dǎo)出，如下圖所示：

六、導(dǎo)入 DOCWAY 數(shù)據(jù)

支持 DOCWAY 復(fù)制分享地址的方式導(dǎo)入數(shù)據(jù)。

使用方法：打開 DOCWAY，進(jìn)入對(duì)應(yīng)項(xiàng)目，鼠標(biāo)移到左上角更多功能點(diǎn)擊分享項(xiàng)目(注意僅項(xiàng)目創(chuàng)建者有權(quán)限分享項(xiàng)目)，創(chuàng)建分享 (注意“閱讀密碼”必須設(shè)置為空)，然后復(fù)制分享地址將地址黏貼到下面輸入框。如下圖所示：

Apifox軟件快捷鍵

新建快捷調(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

???????

Apifox軟件功能

一、一站式接口協(xié)作平臺(tái)

Apifox = Postman + Swagger + Mock + JMeter

一套系統(tǒng)、一份數(shù)據(jù)，解決多個(gè) API 工具之間的數(shù)據(jù)同步問題

只要定義好 API 文檔，API 調(diào)試、API Mock、API 自動(dòng)化測(cè)試即可直接使用，無需再次定義。

API 文檔和 API 開發(fā)調(diào)試使用同一個(gè)工具，API 調(diào)試完成后即可保證和 API 文檔定義完全一致。

二、接口設(shè)計(jì)所見即所得

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

三、一次請(qǐng)求，重復(fù)調(diào)用

無需提前定義接口即可快速調(diào)試。支持設(shè)置環(huán)境變量、前置/后置腳本、Cookie/Session 全局共享等功能。接口運(yùn)行調(diào)試完成后支持一鍵保存，后續(xù)無需輸入?yún)?shù)即可重復(fù)運(yùn)行接口用例，十分便利。

四、自動(dòng)生成代碼

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

更重要的是：你可以通過自定義代碼模板來生成符合自己團(tuán)隊(duì)的架構(gòu)規(guī)范的代碼，滿足各種個(gè)性化的需求。

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

五、智能化接口管理

使用 Apifox 調(diào)試接口的時(shí)候，系統(tǒng)會(huì)根據(jù)接口文檔里的定義，自動(dòng)校驗(yàn)返回的數(shù)據(jù)結(jié)構(gòu)是否正確。不再需要通過肉眼識(shí)別，也無需手動(dòng)寫斷言腳本檢測(cè)。運(yùn)行接口用例時(shí)會(huì)自動(dòng)校驗(yàn)數(shù)據(jù)正確性，提升調(diào)試效率。根據(jù)接口及數(shù)據(jù)數(shù)據(jù)模型定義，系統(tǒng)還能夠自動(dòng)生成接口請(qǐng)求代碼、前端業(yè)務(wù)代碼及后端業(yè)務(wù)代碼。

六、豐富的實(shí)用能力

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

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

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

- Apifox 根據(jù)接口定義里的數(shù)據(jù)結(jié)構(gòu)、數(shù)據(jù)類型，自動(dòng)生成 mock 規(guī)則。

- Apifox 內(nèi)置智能 mock 規(guī)則庫(kù)，根據(jù)字段名、字段數(shù)據(jù)類型，智能優(yōu)化自動(dòng)生成的 mock 規(guī)則。如：名稱包含字符串image的string類型字段，自動(dòng) mock 出一個(gè)圖片地址 URL;包含字符串time的string類型字段，自動(dòng) mock 出一個(gè)時(shí)間字符串;包含字符串city的string類型字段，自動(dòng) mock 出一個(gè)城市名。

- Apifox 根據(jù)內(nèi)置規(guī)則，可自動(dòng)識(shí)別出圖片、頭像、用戶名、手機(jī)號(hào)、網(wǎng)址、日期、時(shí)間、時(shí)間戳、郵箱、省份、城市、地址、IP 等字段，從而 Mock 出非常人性化的數(shù)據(jù)。

- 除了內(nèi)置 mock 規(guī)則，用戶還可以自定義規(guī)則庫(kù)，滿足各種個(gè)性化需求。支持使用 正則表達(dá)式、通配符 來匹配字段名自定義 mock 規(guī)則。

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

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

4、接口自動(dòng)化測(cè)試：

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

七、云端團(tuán)隊(duì)協(xié)作

接口信息云端實(shí)時(shí)同步更新，天生響應(yīng)團(tuán)隊(duì)協(xié)作。成熟的團(tuán)隊(duì)/項(xiàng)目/成員權(quán)限管理系統(tǒng)滿足各類企業(yè)的需求。數(shù)據(jù)模型之間支持相互引用，同樣的數(shù)據(jù)結(jié)構(gòu)，只需要定義一次即可多處使用;修改時(shí)僅需修改一處，多處實(shí)時(shí)更新。

八 、兼容多種數(shù)據(jù)格式

1、支持導(dǎo)出 OpenApi (Swagger)、Markdown、Html 等數(shù)據(jù)格式，因?yàn)榭梢詫?dǎo)出OpenApi格式數(shù)據(jù)，所以你可以利用 OpenApi (Swagger) 豐富的生態(tài)工具完成各種接口相關(guān)的事情。

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

3、支持定時(shí)自動(dòng)導(dǎo)入OpenApi (Swagger)、apiDoc、Apifox格式數(shù)據(jù)。