事情是這樣的：今天我們公司的後端說他接口寫完了，並分享了一個接口文檔給我。用的就是 Swagger UI 自動生成的那種接口文檔，就像這種：
這種 Swagger UI文檔我每次看着就頭大，毛病多多
時間比較緊急，我就按照他給的文檔里的參數與響應數據，寫到了我的前端頁面上，前端這邊簡單自測了一下就匆匆上線了。
上線完當晚就炸了。。
頁面上各種接口報錯：
老大馬上過來找我倆，但是前後端各執一詞：
歸根結底是個成本問題這時候老大很冷靜，阻止了我們的吵架。
老大分析了一下這次事故的主要原因：
然後老大說，這歸根結底是個成本問題。要是前後端測接口都特別簡單方便，你們這個問題就不存在了嘛！
你們現在用的在線接口文檔，功能幾乎為零。應該選一個功能更加強大的在線接口文檔工具，直接在線就把接口調了，你們是不是就不會出這些問題了。
這個工具應該具備以下功能：
我們紛紛點頭，是啊是啊。
老大說，我最近試了一款工具，就可以零成本地解決你們這些問題！
然後他給我們看了一個神仙文檔。
就是這個！！⬇️⬇️⬇️
為什麼說它神仙呢？因為它滿身都是牛逼到不行的特性，比平常見到那些 API 文檔不知道高到哪裡去了。
在線調試這個文檔是用 Apifox 做的，我之前有試用過這個工具，完全免費不限功能的，沒想到最近又有這麼多厲害的新功能出來了。
點擊文檔右上角的運行按鈕，就會出現「在線運行」的模塊
這個界面上就能直接調試接口了！直接 1. 填參數，2. 選環境，3. 點發送，接口請求就發出去了！下面就有返回結果！根本用不着 Postman！更不用把 API 照着抄一遍！
我心想，如果當時上線之前，用的是 Apifox 的話，那簡直是不會出現事故：
自動生成我跟老大說，這個功能看起來是很強大啊。可是要是上線時間緊，誰有功夫去搞這麼個接口文檔啊，配置起來應該很麻煩吧？
老大邪魅一笑。
他說，這個文檔，是自！動！生！成！的！
只要把 Swagger 的 URL 填到 Apifox 裡面去，Apifox 就會自動導入 API 定義，然後就能生成這個好用的文檔！
後端隨便改代碼，前端隨時可以在線調試！
而且，還可以導入多個來源的 Swagger！一套接口文檔來自多個不同的後端項目也沒問題！
生成請求代碼後端說，不就是一個在線調試接口嗎，也沒有到神仙的地步嘛。
老大說，你還是太年輕。
在這個在線文檔頁面上，還有一行熟悉的 icon。這是什麼呢？
自！動！生！成！代！碼！
點擊對應的語言，就能直接生成請求的代碼！？？？
我選擇了 JavaScript 之後，居然還提供了 Fetch、Axios、Jquery 等等請求方式的代碼？？？
我直接 copy 一下代碼，粘進代碼里就能用？？？
一個在線文檔，捲成這樣至於嘛？？？
生成模型代碼老大說，別急，還沒完。
API 文檔嘛，都會有個「返迴響應」的模塊，就是告訴你後端吐出來的數據是什麼類型什麼長度等等。前端再寫個數據結構把這些數據接着，然後放進頁面里去。
在這個神仙文檔里呢，「返迴響應」里也有個「生成代碼」。
我點了一下，就彈出了這個框：
左邊還可以選擇你生成代碼的配置，包括：編程語言、命名風格、校驗開啟等等。
我看了看，Java，C，C++，JS，Swift，Go，Python，TypeScript……基本上我知道的語言全都有。
怎麼着？返回數據結構的代碼也不用寫了？複製一下粘過去就行了？
我默默翻了翻它自動生成的代碼，又關上了。
我感覺我自己寫的 Java 代碼還沒它自動生成寫的好。
雲端 Mock我說老大，我明白了。我這就去下載 Apifox，下個迭代我就用這個在線文檔。哦不，下個迭代我就逼後端用這個在線文檔。
老大說，急什麼。等我說完。你知道雲端 Mock 嗎？
我說，雲嘛，神仙都是要駕雲的，這很正常。
老大說你正常一點。雲端 Mock，就是在 API 文檔頁面上就直接實現 Mock 服務，虛擬一個服務端出來。
我：？？？
老大說，比如，我們要請求一個銀行的 API，銀行肯定不會讓你隨便請求啊，都是要驗證身份限制次數的。用這個 Apifox 呢，你就可以直接在接口文檔上請求 Mock 數據了，也不會限制你的次數，也不會收你的錢。
我說老大，咱們是不是跳得有點快。你駕雲我跟不上的。
老大說沒有啊，我們不是在聊這個在線文檔的特性嘛。你看，這裡有測試環境、正式環境和雲端 Mock 環境，你只要切換到雲端 Mock 環境，請求就會發給 Mock 服務器了，跟正式環境調試一樣一樣的。
我：！！！！！
還可以這樣？？
老大又用瀏覽器打開了這個 URL（https://mock.apifox.cn/m1/1035644-0-default/users/2），說你看，直接訪問 URL 就能獲取到 Mock 數據了，你們前端用起來是不是很爽？
我猛點頭。
這個時候，後端說，那是不是我們直接把常用的那些第三方 API 都做成這種能雲端 Mock 的 API 文檔，然後開發就都能直接調試第三方接口了？連 Mock 服務器都不用架？
我：
API Hub老大說，你們啊，too young too simple，sometimes naive.
給你們看個東西。
這個，叫做 API Hub。
在 Apifox 裡面，已經把這些最常用的第三方 API 都做好了！即時通訊的，電商的，查快遞的，項目管理的，統統都有！每一個都可以在線運行！生成代碼！也可以克隆到自己的項目里，然後用雲端 Mock！
企業微信的 API 文檔，可以在線運行老大說，人家都把接口文檔公開出來了，你們也好好學學人家大廠的接口是怎麼設計的。哦對了，咱們公司有接口要公開出去的話，也可以發布到這個 API Hub。
老大說，好了，我說完了。你們都聽懂了嗎？
我說，懂了，明天就去跟後端對線。
後端說，等什麼明天！我現在就要！
Apifox最後，老大語重心長地說，年輕人啊，還是要多學學先進技術和工具。
Apifox = Postman + Swagger + Mock + JMeter。集接口文檔工具、接口 Mock 工具、接口自動化測試工具、接口調試工具於一體，提升 10 倍研發效率。
在這些核心功能之外，Apifox 還提供了大量創新的圍繞 API 的擴展特性，適合各種規模的開發團隊使用。
而且我看他們官方還有預告，後續會支持更強大的文檔功能，包括自定義域名、自定義導航、多主題樣式選擇、自定義 css、自定義頁面等等等等，你們都要關注一下。
要是使用過程中有問題的話，還可以加入 Apifox 用戶群提問和學習。
趕緊點擊「閱讀原文」去下載吧
下載鏈接：http://apifox.cn/a1jxkxiu
或者，複製上面鏈接，去官網下載吧
留言列表