OpenAPI規范3.0版接近最終發布

英文原文：The OpenAPI Spec Reaches 3.0

“開放 API 戰略”(Open API Initiativev) 發布了 OpenAPI 規范 3.0 版的預覽，并規劃于今年二月底發布實施草案（Implementer Draft）。

新的 OpenAPI 規范 3.0帶來了如下重大改進：

• 為實現更好的可重用性，對規范的整體架構進行了重構，重構后的架構如下圖所示。
• 支持 oneOf、anyOf 和 not 的 JSON 模式。
• 可使用模式的參數。
• 引入了 Cookie 參數，去除了 dataForm 參數。
• 具有自身實體的主體參數（Body Parameter）。
• 可協商的內容類型。
• 多主機支持。
• 簡化了安全定義，改進的 WebHooks 不再通過回調機制描述。

“開放 API 戰略”作為負責規范開發的組織，計劃在今年二月底前給出首個帶來了。

已公布的 OpenAPI 規范目標是：

定義標準的、獨立于語言的指向 REST API 的接口，使得服務能力無需訪問源代碼、文檔，或是借助于網絡流量檢查，就可被人類和計算機發現并理解。通過對 OpenAPI 做適當定義后，消費者可使用最小數量的實現邏輯理解遠程服務，并與遠程服務交互。

OpenAPI 基于 Swagger 2.0 構建，Swagger 是 SmartBear 貢獻給 Linux 基金會的。意在構建具有中立管理模型的新組織，以引領 Swagger 更上一層樓。“開放 API 戰略”的創始成員包括對貢獻具有興趣的 Google、IBM 和 Microsoft。同時還成立了一個技術開發者社區（TDC，Technical Developer Community）以對規范做開發。TDC 對于任何有意向做出貢獻的個人都是開放的，無需會員身份。

在對“上百個任務單和上千條評論”近一年的處理工作后，現在 OpenAPI 規范已接近于最終發布，不會再有任何其他重大改進。

來自: InfoQ