Open API Initiative釋出OpenAPI規範3.0.0

Open API Initiative釋出了OpenAPI規範（OAS）3.0.0版本。

\\

歷經將近兩年的開發和7個月的釋出流程，從2017年1月開始發表宣告，到2月份釋出實現草案，再到6月份公開討論，這一版本才得以誕生。InfoQ之前報導過OAS 3.0的關鍵新特性，包括支援回撥、多主機、改進的JSON Schema，以及新增新的內容，如Components和Links。

\\

社群反響熱烈，Twitter上滿是表達祝賀和激動心情的推文，開源和商用工具也開始大力支援OAS 3.0。3.0版本既是OAS規範的一個里程碑版本，也是Open API Initiative（OAI）的版本，OAI目前受Linux基金會監管。

\\

OAS技術開發者社群（TDC）的Ron Ratovsky向InfoQ講述了有關3.0版本的發展路徑以及他們在釋出新版本時所面臨的挑戰。OAS託管在GitHub上三年多了，從2014年9月開始，6個TDC成員解決並關閉了580多個問題，還有200多個尚未解決。在談及請求的管理、討論和優先順序安排時，Ratovsky強調，在推進OAS目標時要注重廣大使用者的需求，即標準化和改進對REST API的描述。在這方面，他們已經在討論支援新的協議和新的模式（如GraphQL），不過討論的內容尚未被加入到路線圖中。

\\

OAS 3.0中包含的Links物件被稱為超媒體的“nod”，是為了解決社群中廣泛存在的一個問題而被加入規範的。Links物件是超媒體之外的另一個選擇，它是靜態的，而超媒體是動態且自文件（self-documenting）的，Ratovsky說，“我們想著該如何提供一個方案，最後我們把它定義為靜態的。我們希望得到更多有關Links這一特性的反饋。我們希望能夠擴充套件這一特性，併為超媒體帶來更多的可能性。”

\\

除了Links物件，TDC成員希望能夠得到更多其他方面的反饋。與其他開源專案一樣，OAS也依賴社群的支援和參與。“我們依賴社群的努力——特性請求、發表意見、拉取請求”，Ratovsky說，“我希望能夠收到更多來自產品經理、QA工程師、技術作者和API生命週期相關人員的反饋。我們想知道OAS要怎樣才能讓他們的工作變得更美好。”

\\

使用者可以在OAS的GitHub倉庫裡找到如何參與專案的相關資訊。SmartBear將在8月9號舉辦一個webinar，對實現新特性感興趣或正在從Swagger 2.0遷移到OAS 3.0的人可以關注下。

\\

檢視英文原文：The Open API Initiative Announces the OpenAPI Specification 3.0.0