界面風(fēng)格

使用過(guò)swagger-bootstrap-ui的朋友應(yīng)該都知道，它是基于左右菜單式的布局方式,這和目前大部分后臺(tái)管理系統(tǒng)有些類似，使用這種風(fēng)格的原因,我想應(yīng)該是更符合國(guó)人的操作習(xí)慣吧.

相比較swagger-ui的上下依次鋪開(kāi)的結(jié)構(gòu)，我想這種方式更適合接口對(duì)接人員.

每個(gè)接口文檔主要通過(guò)文檔說(shuō)明和在線調(diào)試兩個(gè)核心tab組件展開(kāi)介紹,同時(shí)打開(kāi)文檔說(shuō)明則會(huì)以多tab的方式逐次展開(kāi)文檔說(shuō)明,來(lái)回切換查看不同接口文檔說(shuō)明,方便快捷.

如下圖：

文檔說(shuō)明：會(huì)根據(jù)Swagger的標(biāo)準(zhǔn)JSON文件,詳細(xì)的列出該接口的信息說(shuō)明,主要包括：接口地址、接口類型、produces、consumes、接口參數(shù)字段說(shuō)明、請(qǐng)求示例、響應(yīng)參數(shù)說(shuō)明、響應(yīng)狀態(tài)碼、響應(yīng)示例

在線調(diào)試：開(kāi)發(fā)者可以基于此文檔進(jìn)行接口的調(diào)試,ui會(huì)根據(jù)接口的信息自動(dòng)列出請(qǐng)求參數(shù)、請(qǐng)求地址等信息,開(kāi)發(fā)者只需要填寫(xiě)相應(yīng)的字段值即可聯(lián)調(diào)測(cè)試