swagger api接口調用指南 · javabbc開發文檔

# swagger api接口調用指南系統訪問swagger API地址：[https://demo.mallsuite.cn/api/doc.html](https://demo.mallsuite.cn/api/doc.html) #### 一：gateway路由配置 ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_74236542953c23675b269b755a866872_r.png "null") 上圖為代碼中的gateway配置： ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_4150077fd0e8c54c35d65a2a3c1b15cb_r.png "null") 以下為gateway具體配置信息： ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_6b32223b50b3540292e121b253cdacb5_r.png "null") gateway訪問端口號： 8201 例如， /mall-account/admin/account/account-user-base/info 通過gateway 默認訪問地址為：ip：8201/admin/account/account-user-base/info {去掉mall-account, gateway路徑配置決定了} 線上，配置的域名訪問的時候，gateway為80端口，并做了一個網址代理映射，未加nginx代理前線上訪問地址為：[https://demo.mallsuite.cn/admin/account/account-user-base/info](https://demo.mallsuite.cn/admin/account/account-user-base/info) nginx配置截圖： ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_33f65b2213cd933ec3b05cefbf2fa48b_r.png "null") 線上配置代理后，在域名前，配置了一個api，所以[https://demo.mallsuite.cn/admin/account/account-user-base/info](https://demo.mallsuite.cn/admin/account/account-user-base/info)訪問應該改為：[https://demo.mallsuite.cn/api/admin/account/account-user-base/info](https://demo.mallsuite.cn/api/admin/account/account-user-base/info) #### 二、調用演示說明線上調用的位置為：域名/api，這個是訪問到我們線上演示版gateway的: ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_63f1d216e7f8908c373fbdc93b14092d_r.png "null") 可以通過此處，設置默認的gateway方位地址，不需要每次都修改單獨接口網址了。另外，調用接口需要鑒權，我們可以調用獲得token的接口，如下圖： ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_c198218176b817408b5874c42828921b_r.png "null") ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_a74ee2b5e796371d3ffbcddceea8da89_r.png "null") 下圖為代碼中gateway路徑配置： ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_6aad68b50b39688fdc59c71031515ec1_r.png "null") 請求成功后返回的結果如圖所示： ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_9607a32ea81a1ba0430c05afc3ca276d_r.png "null") 全局設置 Authorization header，注意：設置token的時候一定要加上Bearer加個空格與token分開，下圖所示： ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_ef3c75410ece5eab0309d744d049b647_r.png "null") 上圖這兒設置后，刷新下頁面，則所有微服務接口，都會自帶設置好token。 #### 三、實際使用案例例如，去獲取當前用戶信息，切換到mall-account服務接口如圖所示: ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_370cbf23e7508d105fe70f7767133ceb_r.png "null") ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_e7c29006444038fcaf3f17d010ae1e1d_r.png "null") ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_028c1ee05c14d2b1f3012f1ef3f0bd9a_r.png "null") ![](https://docs.suteshop.com/uploads/shopsuite-java/images/m_5b6b0f8a9434c74d18c2b7a0d7a3f5e7_r.png "null") 至此，線上swagger api演示完成