久久国产成人av_抖音国产毛片_a片网站免费观看_A片无码播放手机在线观看,色五月在线观看,亚洲精品m在线观看,女人自慰的免费网址,悠悠在线观看精品视频,一级日本片免费的,亚洲精品久,国产精品成人久久久久久久

分享

公司自用的國(guó)產(chǎn)API管理神器

 小虛竹 2022-07-05 發(fā)布于福建

1,、前言

虛竹哥從事后端開發(fā),平時(shí)寫的后端接口,是以swagger生成API接口文檔,提供給前端調(diào)用,與前端交互的文檔;然后用Postman 自測(cè)接口,有些性能要求的接口會(huì)用JMeter 進(jìn)行接口性能測(cè)試,。有時(shí)開發(fā)前端時(shí),要Mock一些數(shù)據(jù),會(huì)用Mock.js來(lái)處理。從事后端工作不容易,要掌握多種工具來(lái)配合日常的工作,。

這些軟件在使用上,存在一些問(wèn)題:

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

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

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

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

  1. 前端根據(jù) mockjs Mock 出來(lái)的數(shù)據(jù)開發(fā)完,后端根據(jù) Swagger 定義的接口文檔開發(fā)完,各自都測(cè)試通過(guò)了,本以為可以馬上上線,結(jié)果一對(duì)接發(fā)現(xiàn)各種問(wèn)題:

    1. 開發(fā)過(guò)程中接口變更了,只修改了 Swagger,但是沒(méi)有及時(shí)同步修改 mockjs,。

    2. 后端開發(fā)的接口數(shù)據(jù)類型和文檔不一致,肉眼難以發(fā)現(xiàn)問(wèn)題,。

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

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

后來(lái)公司的技術(shù)總監(jiān)在公司推行Apifox :集 API 文檔,、API 調(diào)試、API Mock,、API 自動(dòng)化測(cè)試一體化協(xié)作平臺(tái),。

我對(duì)這款Apifox 有了一定的了解,跟大家分享分享。

2,、Apifox介紹

2.1,、Apifox是什么

Apifox 是 API 文檔、API 調(diào)試,、API Mock,、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 開發(fā)調(diào)試使用同一個(gè)工具,API 調(diào)試完成后即可保證和 API 文檔定義完全一致,。高效,、及時(shí)、準(zhǔn)確!

2.2,、Apifox如何解決痛點(diǎn)問(wèn)題

2.2.1,、Apifox 核心功能

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

數(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í)組合模式,。

接口調(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ǔ)言代碼,。

接口用例:通常一個(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)試接口非常高效。

接口數(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ù),具體在本文后面介紹。

數(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è)試更多功能還在開發(fā)中,敬請(qǐng)期待!目標(biāo)是: JMeter 有的功能基本都會(huì)有,并且要更好用。

快捷請(qǐng)求:類似 Postman 的接口調(diào)試方式,主要用途為臨時(shí)調(diào)試一些無(wú)需文檔化的接口,無(wú)需提前定義接口即可快速調(diào)試,。

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

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

2.2.2,、Apifox 做的不僅僅是數(shù)據(jù)打通

如果你認(rèn)為 Apifox 只做了數(shù)據(jù)打通,來(lái)提升研發(fā)團(tuán)隊(duì)的效率,那就錯(cuò)了。Apifox 還做了非常多的創(chuàng)新,來(lái)提升開發(fā)人員的效率,。

2.2.2.1,、接口支持“用例管理”

通常一個(gè)接口會(huì)有多種情況用例,比如 正確用例 參數(shù)錯(cuò)誤用例 數(shù)據(jù)為空用例 不同數(shù)據(jù)狀態(tài)用例。定義接口的時(shí)候定義好這些不同狀態(tài)的用例,接口調(diào)試的時(shí)候直接運(yùn)行,非常高效,。

2.2.2.2,、“數(shù)據(jù)模型”定義、引用

可以獨(dú)立定義數(shù)據(jù)模型,接口定義時(shí)可以直接引用數(shù)據(jù)模型,數(shù)據(jù)模型之間也可以相互引用,。同樣的數(shù)據(jù)結(jié)構(gòu),只需要定義一次即可多處使用;修改的時(shí)候只需要修改一處,多處實(shí)時(shí)更新,避免不一致,。

2.2.2.3、調(diào)試時(shí)“自動(dòng)校驗(yàn)”數(shù)據(jù)結(jié)構(gòu)

使用 Apifox 調(diào)試接口的時(shí)候,系統(tǒng)會(huì)根據(jù)接口文檔里的定義,自動(dòng)校驗(yàn)返回的數(shù)據(jù)結(jié)構(gòu)是否正確,無(wú)需通過(guò)肉眼識(shí)別,也無(wú)需手動(dòng)寫斷言腳本檢測(cè),非常高效!

2.2.2.4,、“可視化”設(shè)置斷言

設(shè)置斷言:

運(yùn)行后,查看斷言結(jié)果:

2.2.2.5,、“可視化”設(shè)置提取變量

2.2.2.6、支持?jǐn)?shù)據(jù)庫(kù)操作

2.2.2.7,、“零配置”Mock 出非常人性化的數(shù)據(jù)

先放一張圖對(duì)比下 Apifox 和其他同類工具 零配置 mock 出來(lái)的數(shù)據(jù)效果:

可以看出 Apifox 零配置 Mock 出來(lái)的數(shù)據(jù)和真實(shí)情況是非常接近的,前端開發(fā)可以直接使用,而無(wú)需再手動(dòng)寫 mock 規(guī)則,。

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

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

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

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

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

3,、實(shí)操

3.1、下載

下載網(wǎng)址,可以點(diǎn)這里 Apifox ,支持 Windows(64 位),、Windows(32 位),、MacOS(Intel 芯片)、MacOS(M1 芯片),、Linux(.Applmage),、Linux(.tar.gz)。

你也可以使用 Web 端版本使用(如果需要導(dǎo)入文檔,建議使用客戶端)

3.2,、安裝

根據(jù)安裝包的指引即可完成,。

3.3、注冊(cè)賬戶

推薦使用微信掃碼登錄,如果沒(méi)有賬戶會(huì)新建賬戶,只需掃碼就可完成,以后登錄只需要微信掃碼即可,。

同時(shí)也支持郵箱注冊(cè),。

3.4、創(chuàng)建團(tuán)隊(duì)

登錄成功后,顯示為團(tuán)隊(duì)頁(yè)面,。我們會(huì)為您提供一個(gè)示例團(tuán)隊(duì)中的示例項(xiàng)目,您可以點(diǎn)擊進(jìn)入,對(duì)軟件進(jìn)行一些學(xué)習(xí)和探索

您也可以新建一個(gè)自己的團(tuán)隊(duì),如下圖

您也可以讓您團(tuán)隊(duì)成員邀請(qǐng)您進(jìn)入已有團(tuán)隊(duì),接受邀請(qǐng)時(shí),可以點(diǎn)擊右上角鈴鐺處操作,。

3.5、創(chuàng)建項(xiàng)目

如下圖,可以點(diǎn)擊新建項(xiàng)目,建立新的項(xiàng)目

?

3.6,、 進(jìn)入項(xiàng)目

這里以新建項(xiàng)目為參考講解,您可以通過(guò)《🦊一分鐘,了解 Apifox!》了解大致的內(nèi)容,也可以點(diǎn)擊《20 分鐘學(xué)會(huì) Apifox》觀看視頻

3.7,、 導(dǎo)入

視頻教學(xué) ,有興趣可以看看。

支持導(dǎo)入 OpenApi (原Swagger),、Postman,、HARRAML,、RAP2,、JMeterYApi,、Eolinker,、NEIDOClever,、ApiPost ,、ApizzaDOCWAY,、ShowDoc,、apiDoc,、I/O DocsWADL,、Google Discovery等數(shù)據(jù)格式,方便舊項(xiàng)目遷移,。

?

3.8、導(dǎo)出

文檔教學(xué) ,有興趣可以看看,。

支持直接導(dǎo)出 OpenAPI (原Swagger),、HTMLMarkdown 等數(shù)據(jù)格式,。

3.9,、 接口概覽頁(yè)

3.10、接口設(shè)計(jì)界面

詳細(xì)可以查看 接口設(shè)計(jì)教學(xué)

接口設(shè)計(jì)即定義接口文檔規(guī)范(如接口路徑,、參數(shù),、返回值、數(shù)據(jù)結(jié)構(gòu)等),。

和 Postman 不一樣,Apifox 是區(qū)分接口設(shè)計(jì)接口運(yùn)行兩個(gè)概念的,。

  • 接口設(shè)計(jì):即 新建接口 界面或接口詳情里的 編輯 界面,用途是 定義接口文檔規(guī)范,而不是 運(yùn)行 接口,所以該界面是只能定義接口基本信息、參數(shù)名及參數(shù)說(shuō)明等,而不能設(shè)置參數(shù)值,。參數(shù)值,、前置腳本/后置腳本 等信息請(qǐng)?jiān)?code>接口運(yùn)行界面或接口用例界面填寫。

  • 接口運(yùn)行:即接口詳情里的 運(yùn)行 界面,用途是 臨時(shí)調(diào)試接口,運(yùn)行 完后,需要點(diǎn)擊保存為用例,才能將填寫的 參數(shù)值,、前置腳本/后置腳本 等信息保存下來(lái);否則關(guān)閉 tab 后,這些信息將會(huì)丟失,。

3.11、 接口運(yùn)行界面

4,、總結(jié)

活到老學(xué)到老,與時(shí)俱進(jìn)學(xué)習(xí)新的技術(shù),新的工具,果然可以提高生產(chǎn)效率,。

如何下載使用,請(qǐng)看文章的實(shí)操環(huán)節(jié),有教學(xué)指導(dǎo)

    轉(zhuǎn)藏 分享 獻(xiàn)花(0

    0條評(píng)論

    發(fā)表

    請(qǐng)遵守用戶 評(píng)論公約

    類似文章 更多