開發(fā)者的瑞士軍刀,目測要火!
降本增效是企業(yè)追求的永恒目標。
如今,前后端分離早已成為互聯(lián)網(wǎng)的標配,大家在享受這種開發(fā)模式帶來的便利同時,也體會到一些痛點,比如:
一個需要幾十個、上百個應用協(xié)作配合的項目,其中可能涉及到成百上千個API——API的管理逐漸成為開發(fā)、聯(lián)調、測試中的痛點問題。
API研發(fā)和聯(lián)調時存在的痛點:
開發(fā)團隊使用多個API工具 (Postman、Yapi、Swagger等),多個工具之間數(shù)據(jù)難以打通; API文檔編寫繁瑣、設計不規(guī)范、缺乏統(tǒng)一文檔格式等; 缺乏版本管理,API變更沒有通知; 測試人員難以維護測試用例,大量使用腳本的方式寫自動化測試,學習、編寫和維護的成本都很高。
痛點解決路徑:
DTDD(文檔與測試驅動開發(fā)) 形成標準文檔,讓各個團隊(開發(fā),測試,運維)協(xié)作有跡可循 用測試結果,推動項目進度,團隊溝通更加通暢,項目管理可量化
API管理之路
起初我們用Swagger進行接口管理,但是發(fā)現(xiàn)它在調式功能方面非常弱,就加上Postman做接口調試,然而Postman的Mock功能比較弱,同時團隊人數(shù)比較多,接口導入導出非常麻煩,且Swagger網(wǎng)頁和Postman來回切也比較費勁,新增加接口或接口參數(shù)變更同步給其他人十分麻煩。
此時,一個好用的API管理工具會極大提高大家的工作效率,在做技術內部提效時,我們一直希望尋找到更好的API管理工具,隨后鎖定Apipost。
官網(wǎng)地址:https://www.apipost.cn/?utm_source=10099
官網(wǎng)介紹,ApiPost = 接口調試+接口文檔快速生成+接口文檔規(guī)范化管理+Mock API+接口流程測試;即:Apipost=Swagger+Postman+Mock;
Apipost恰好能解我們現(xiàn)在的痛點,于是我自己進行了試用,在短短十幾分鐘試用后,就對它愛不釋手,經(jīng)過一段時間的深度使用后,發(fā)現(xiàn)Apipost不僅適合后端研發(fā),前端研發(fā),測試人員以及技術經(jīng)理使用也會非常容易上手,極大提高了團隊的協(xié)作效率。
以下,通過列舉對比我使用過的API相關工具:

帶你玩轉Apipost
對于多年從事大型互聯(lián)網(wǎng)老兵來說,是否是一個用心打磨過的好產品,是否好用,一上手便知;Apipost是真的香!總結如下:
不僅提供了基礎的接口調試功能,而且具備文檔共享貼心功能,同時,還為我們提供了更加強大的腳本錄制,更是站在團隊管理的角度具備非常實用的團隊管理及項目管理功能,而且非常多的功能十分走心,比如:
1)業(yè)務測試場景化
一個業(yè)務線需要N個接口相互依賴,通過接口間傳參完美解決;
2)利用預執(zhí)行腳本發(fā)送一個請求
之前經(jīng)常遇到一種場景,需要將請求結果綁定到變量,然后在當前接口的請求參數(shù)中使用這個變量。Apipost支持使用類似下面的腳本輕松實現(xiàn):
apt.variables.set("token",?response.json.token);?//?token?是接口返回字段
注:response.json是json格式的響應結果。
3)數(shù)據(jù)備份還原
再也不用擔心數(shù)據(jù)丟失,以及多設備間數(shù)據(jù)共享問題;
4)響應結果分屏
在遇到大的入?yún)⒄埱髸r再也不用上拉下拉,極大提升了工作空間;

5)私有部署
再也不用擔心數(shù)據(jù)安全,及網(wǎng)絡問題;
還有非常多的功能,趕緊來體驗解鎖吧!
Web版鏈接(不用下載)
https://console.apipost.cn/register?utm_source=10099
客戶端下載地址:
https://www.apipost.cn/download.html?utm_source=10099
Apipost實操
發(fā)送API請求

API活文檔
之前經(jīng)常聽到抱怨:系統(tǒng)爛得和屎一樣,文檔都是錯的,開發(fā)人員都換了N波了,根本沒法維護?。?!
敏捷開發(fā)不是不在文檔上浪費太多時間嗎?怎么還需要不斷去寫文檔、更新文檔?而且沒人看,浪費時間!
編寫文檔是一件很無聊的事情!
文檔不保持最新,常常會產生誤導,使得大家認知更加混亂!
一線開發(fā)工作者各種吐槽文檔無法實時更新,無法很好地與人共享。于是出現(xiàn)很多工程提效團隊去做文檔優(yōu)化,我自己也見過很多開源的以及公司內部使用的,總體來說都在易用性上、共享等各個方面差些意思,直到遇見Apipost,完美解決了我自己遇到以及聽同事反饋的所有難用的地方。
接下來為大家詳細介紹下如何生成API文檔以及分享給其他人。
分享API文檔

打開分享連接

進階玩法-腳本
腳本實現(xiàn)功能
測試(斷言)請求返回結果的正確性(后置腳本) 動態(tài)修改接口請求參數(shù),如增加接口簽名參數(shù)等(前置腳本) 接口請求之間傳遞數(shù)據(jù)(使用腳本操作變量) 腳本中可以直接請求一個接口地址 預執(zhí)行腳本

后執(zhí)行腳本

發(fā)送結果

更多功能
文章篇幅有限更多好用的功能,歡迎大家親自體驗并掃碼加入官方企業(yè)微信社群進行交流。
Web版鏈接(不用下載)
https://console.apipost.cn/register?utm_source=10099
客戶端下載地址:
https://www.apipost.cn/download.html?utm_source=10099
總結
工欲善其事必先利其器。當下是大規(guī)模合作的時代,專業(yè)的人要保證足夠的精力做專業(yè)的事。既然有了Apipost這么好用且專業(yè)的工具,我們就應該快速地學習并熟練地使用它,從而大大提高我們的工作效率,完全沒有必要再去花時間去自研API管理工具。
注:本文作者目前就職于阿里巴巴專注于Java、大數(shù)據(jù)及人工智能;致力于用技術改變生活。
