在項目開發測試中，接口文檔是貫穿始終的。前後端開發需要在開發前期進行接口定義並形成文檔，QA在功能測試和接口測試的環節也需要依賴於這些接口文檔進行測試。接口文檔往往以最簡單的靜態文檔的形態存在。然而在緊張的敏捷開發模式下，隨著版本迭代，很多接口發生了變化或者被廢棄，而開發幾乎不會在後期去更新這種靜態文檔。QA人員閱讀“過期”的接口文檔是一件痛苦的事情，與開發的溝通成本不降反升、而這些不便於及時維護的靜態文檔，隨著時間的推移最終無人問津。因此我們想找到一種長期可維護且輕量便捷的接口文檔工具。下面介紹幾種接口文檔工具：
DOClever
這是在所有接口管理平臺中我覺得功能做最好的一個了，功能齊全，完全開源免費，支持內網部署！可根據接口的業務場景進行自動化測試、支持項目和團隊兩種協作模式、可根據項目的迭代在不同的版本間進行切換和回滾、mock 的無縫整合，讓你前後端的協作行雲流水、可以對接口信息進行編輯管理、在線接口文檔，支持 https 和 https 協議等；
Eolinker
這是在所有接口管理平臺中我覺界面做的最好的，基本上功能相對來說比較齊全，項目管理到接口管理，支持團隊協作，接口測試，版本管理，在線分享，導入導出等
RAP
RAP 算是比較早做接口管理這塊了（好像是阿里的一個團隊開發的），不過接口管理的功能上來說就有一些遜色了，文檔信息不夠詳細，團隊協作那塊第一次用的時候我真的是完全懵逼了，而且界面真的是有些簡陋（感覺像是後臺開發人員寫的界面），不過接口管理的基本功能都有，支持版本管理，mock 測試，導入導出，而且是開源的，文檔也比較詳細，大家有時間的話可以以此為基礎開發自己想要的功能咯。
easyAPI
接口文檔相對簡單，不過對於那些喜歡簡單接口文檔的朋友來說，easyAPI 也不失為一個不錯的選擇，界面簡單明瞭，配色粉藍粉藍很可愛，不過在我試用的過程中，界面好像不是很穩定，有些按鈕點擊時沒有反應，圖標時可見時不可見。而且因為接口文檔和接口測試不是在一個菜單之下的，兩個功能之間的轉換有些費力。同時也有回收站，版本管理等功能，總的來說，就是比 eolinker 簡單，比 rap 好看。
不過接口測試的功能還是挺強大的，左邊填數據，右邊顯示結果，感覺還是挺直觀的，如果能支持本地測試就更好啦。
Apizza
用過 DHC 的朋友應該會覺得 apizza 的界面似曾相識，用戶在編輯接口的同時也可以進行接口測試，很方便也很簡單，如果只是想使用接口管理平臺進行接口管理和接口測試的朋友，apizza 不失為一個不錯的選擇，功能雖不強大，但十分輕巧簡單，對於用慣 DHC 但英文又差的我而言，第一次看到這個簡直眼前一亮啊有木有。
其他管理工具
1.Swagger:
通過固定格式的註釋生成文檔. 省時省力,不過有點學習成本。
2.Showdoc：
一個非常適合IT團隊的在線API文檔、技術文檔工具。
3.apidoc:
可以根據代碼註釋生成web api文檔，web接口的註釋維護起來更加方便，不需要額外再維護一份文檔。
4.APIJSON：
客戶端可以定義任何JSON結構去向服務端發起請求,服務端就會返回對應結構的JSON字符串,所求即所得。
5.小么雞
閱讀更多 程序猿的內心獨白 的文章
