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 發布

更多資訊可以參考

1. wiki
2. Smart Bear Blog

YAML

兩者均以 YAML 定義，但其結構細節有差異，例如下面是兩者的開頭。

OAS3

openapi: 3.0.1
info:
    title: test 
    description: test

Swagger 2

swagger: "2.0"
info:
    version: "1.0.1"
    title: test