Swagger Editor 是一款針對(duì)REST APIs文檔的在線生成工具，可以生成一個(gè)具有互動(dòng)性的API控制臺(tái)，開發(fā)者可以用來快速學(xué)習(xí)和嘗試API。還可以生成客戶端SDK代碼用于各種不同的平臺(tái)上的實(shí)現(xiàn)。

【功能特點(diǎn)】

　　運(yùn)行在任何環(huán)境

　　編輯器在任何開發(fā)環(huán)境中工作，無論是在本地還是在Web上。

　　智能反饋

　　在編寫簡潔的反饋和錯(cuò)誤處理時(shí)，驗(yàn)證OAS遵從性的語法

　　即時(shí)可視化

　　可視化地呈現(xiàn)API規(guī)范并與API交互，同時(shí)定義它

　　智能自動(dòng)完成

　　用智能和智能自動(dòng)完成更快地編寫語法

　　完全可定制

　　易于配置和定制任何東西，從線間距到主題

　　關(guān)于你的開發(fā)

　　在每個(gè)流行語言中為API生成服務(wù)器存根和客戶端庫

【使用說明】

　　Swagger Editor界面分為導(dǎo)航欄和工作區(qū)。導(dǎo)航欄是對(duì)接口文檔的處理用，工作區(qū)就是我們花時(shí)間最多的地方。分為左右區(qū)域，左邊是編輯區(qū)，右邊是顯示區(qū)。左邊編輯區(qū)使用的YAML語法來編寫，只要一修改右邊顯示區(qū)立刻有變化，使用很便捷。進(jìn)入swagger edit會(huì)默認(rèn)填入一個(gè)demo文檔，通常我們只需要修改demo文檔，就能制作我們想要的接口文檔。

　　編寫完文檔點(diǎn)擊展示區(qū)的excute，進(jìn)行測試接口。

　　File

　　這個(gè)用來導(dǎo)出/引入接口文件在swagger edit里面進(jìn)行編輯，也可以輸出YAML/JSON格式。這個(gè)如果你是非在線版，編輯一半想下次在編輯，建議先導(dǎo)出備份，避免數(shù)據(jù)丟失。

　　convert to YAML

　　把編輯區(qū)轉(zhuǎn)換成YAML格式。

　　Generate Server

　　把接口文檔生成服務(wù)器文件，導(dǎo)出一個(gè)壓縮包，接口文檔生成java、js等服務(wù)器文件。很實(shí)用工具，讓你寫少很多代碼。

　　導(dǎo)出spring-boot

　　導(dǎo)出nodeJS

　　Generate Client

　　生成查看接口文檔。編寫好下一步就是展示。這里可以選擇導(dǎo)出什么格式的接口文檔。