Swagger構建偉大的API

手寫Api文檔的幾個痛點： 文檔需要更新的時候，需要再次發送一份給前端，也就是文檔更新交流不及時。 接口返回結果不明確 不能直接在線測試接口，通常需要使用工具，比如postman 接口文檔太多，不好管理 Swagger也就是爲了解決這個問題，當然也不能說Swagger就一定是完美的，當然也有缺點，最明顯的就是代碼移入性比較強。 Swagger 是一款RESTFUL接口的文檔在線自動生成+功能測試功

>>阅读原文<<