利用Swagger2自動生成對外接口的文檔

一直以來做對外的接口文檔都比較原始，基本上都是手寫的文檔傳來傳去，最近發現了一個新玩具，可以在接口上省去不少麻煩。 swagger是一款方便展示的API文檔框架。它可以將接口的類型最全面的展示給對方開發人員，避免了手寫文檔的片面和誤差行爲。 swagger目前有兩種swagger和swagger2兩種，1比較麻煩，所以不考慮使用。本文主要記錄我用swagger2做對外接口的兩種方式，方面後面查閱。

>>阅读原文<<