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