簡介
Swagger 是最受歡迎的REST APIs文檔生成工具之一
Swagger 可以生成一個具有互動性的API控制臺,開發者可以用來快速學習和嘗試API。
Swagger 可以生成客戶端SDK代碼用于各種不同的平臺上的實現。
Swagger 文件可以在許多不同的平臺上如node,java從代碼注釋中自動生成。
功能
后端負責在線編輯接口文檔,在線可以生成IOS,Android客戶端網絡層代碼,省去編碼時間。如圖:
下面學習Swagger Editor如何編輯
主要分三個部分,第一是版本和協議定義,第二定義接口,第三定義實體Bean
接口定義
第一部分看上圖理解,下面直接看第二部分,分別以get,post,put,delete為例
get栗子
栗子
post栗子
栗子
put栗子
栗子
delete栗子
實體部分
栗子