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 

You Might Also Like

Leave a Reply

這個網站採用 Akismet 服務減少垃圾留言。進一步了解 Akismet 如何處理網站訪客的留言資料