建立私有 Swagger UI 服務

想必常使用 RESTful API 開發的人對於好看好讀的 API Docs 有相當程度的需求,而眾多開源軟體中,最知名的框架就是 Swagger 這個框架,什麼?你說你不知道這是什麼,我相信你一定多多少少應該都有看過這個蠻經典的 petstore.swagger.io API 文件,本文就是要來梳理一下這 Swagger UI 要怎麼放到自家,用容器運行非常簡單

Read More

進擊的 OpenAPI!!!

OpenAPI Specification, OAS

隨著資訊服務的飛增及複雜,各家廠商所提供的底層服務封裝後提供出來的介面,我們稱做 API (Application Program Interface),而 OpenAPI 則是將這些 API 依據某些規範公開出來給第三方使用,可包含免費使用、付費使用或限定使用等方式,有一個公開既定的規範可供參考。

Read More