OAS 3 (Openapi Specification) 小筆記
簡史
一開始,有團隊開發 Swagger Framework,其 Specification 也定名為 Swagger,從 1.0 到 2.0
2015 年底 OpenAPI Initiative 組織成立。 Swagger Specification 2.0 被貢獻給 OpenAPI Initiative
2016 年初 『Swagger Specification』 更名 『OpenAPI Specification』(OAS)
- 自此, Swagger 就是指原本那套 Framework, 而 OAS 是規範
2017 年 OpenAPI Specification 3.0 發布
更多資訊可以參考
YAML
兩者均以 YAML 定義,但其結構細節有差異,例如下面是兩者的開頭。
OAS3
openapi: 3.0.1 info: title: test description: test
Swagger 2
swagger: "2.0" info: version: "1.0.1" title: test
Leave a Reply