不可避免的是定制接口文檔，後端工程師要把單元測試寫好。推薦使用chrome的插件postman或者soapui或者jmeter，服務層的測試用例由junit編寫。
但是這種情況對於界面文檔管理來說是非常不方便的，所以下面介紹壹些互聯網公司常用的界面文檔管理平臺。
Swagger是面向大型API開發者的工具框架，它提出了編寫OpenAPI(名為OAS)的規範，Swagger可以跨整個API生命周期進行開發，從設計和文檔到測試和部署。
Swagger框架的三個核心:
YApi部署流程簡介
YApi是壹個高效、易用、功能強大的Api管理平臺，旨在為開發者、產品和測試人員提供更優雅的界面管理服務。它可以幫助開發者輕松地創建、發布和維護API。此外，YApi為用戶提供了優秀的交互體驗，開發者只需使用平臺提供的界面數據編寫工具和簡單的點擊操作，即可對界面進行管理。特點:
難點:如果妳需要執行自動化測試，妳需要編寫腳本。
Eolinker是國內企業級IT研發管理解決方案服務品牌，在線API接口管理服務商。致力於滿足各行業客戶對不同應用環境下研發管理全生命周期的個性化需求，提供API開發管理(AMS)、開發團隊協作、自動化測試、網關(AGW)、監控(AMT)等服務。
特點:
ShowDoc是壹個非常適合IT團隊的在線API文檔和技術文檔工具。
隨著移動互聯網的發展，後端即服務越來越流行。服務器提供API，數據很容易被APP或者網頁前端調用。用ShowDoc可以非常方便快捷的寫出漂亮的API文檔。
項目地址:/controller/index/index.html。
doc lever GitHub:/sx 1989827/doc lever
阿裏媽媽前端團隊出品的開源界面管理工具RAP二代，通過GUI工具幫助WEB工程師更高效地管理界面文檔，通過分析界面結構自動生成模擬數據，驗證真實界面的正確性，使界面文檔成為開發過程中的強依賴。有了結構化的API數據，RAP可以做更多的事情，我們可以避免更多的重復性工作。基於RAML的接口定義、文檔生成和模擬服務器實現了定義和使用的分離。通過壹套標準化的接口定義，可以使用不同的工具得到適應不同API管理系統的輸出，有更多的可能性，同時保持核心定義不變。與RAML相比，RAP更加集中，所有的定義、文檔、mock都在同壹個服務中完成，實時生效，方便快捷。如果只考慮方便性和易用性，RAP是更好的選擇，而RAML更繁瑣，更適合開放接口定義，方便在系統間流動。
Github源地址:/thx/rap2-delos