Open API Initiative發(fā)布了OpenAPI規(guī)范（OAS）3.0.0版本。

歷經(jīng)將近兩年的開(kāi)發(fā)和7個(gè)月的發(fā)布流程，從2017年1月開(kāi)始發(fā)表聲明，到2月份發(fā)布實(shí)現(xiàn)草案，再到6月份公開(kāi)討論，這一版本才得以誕生。InfoQ之前報(bào)導(dǎo)過(guò)OAS 3.0的關(guān)鍵新特性，包括支持回調(diào)、多主機(jī)、改進(jìn)的JSON Schema，以及添加新的內(nèi)容，如Components和Links。

社區(qū)反響熱烈，Twitter上滿(mǎn)是表達(dá)祝賀和激動(dòng)心情的推文，開(kāi)源和商用工具也開(kāi)始大力支持OAS 3.0。3.0版本既是OAS規(guī)范的一個(gè)里程碑版本，也是Open API Initiative（OAI）的版本，OAI目前受Linux基金會(huì)監(jiān)管。

OAS技術(shù)開(kāi)發(fā)者社區(qū)（TDC）的Ron Ratovsky向InfoQ講述了有關(guān)3.0版本的發(fā)展路徑以及他們?cè)诎l(fā)布新版本時(shí)所面臨的挑戰(zhàn)。OAS托管在GitHub上三年多了，從2014年9月開(kāi)始，6個(gè)TDC成員解決并關(guān)閉了580多個(gè)問(wèn)題，還有200多個(gè)尚未解決。在談及請(qǐng)求的管理、討論和優(yōu)先級(jí)安排時(shí)，Ratovsky強(qiáng)調(diào)，在推進(jìn)OAS目標(biāo)時(shí)要注重廣大用戶(hù)的需求，即標(biāo)準(zhǔn)化和改進(jìn)對(duì)REST API的描述。在這方面，他們已經(jīng)在討論支持新的協(xié)議和新的模式（如GraphQL），不過(guò)討論的內(nèi)容尚未被加入到路線圖中。

OAS 3.0中包含的Links對(duì)象被稱(chēng)為超媒體的“nod”，是為了解決社區(qū)中廣泛存在的一個(gè)問(wèn)題而被加入規(guī)范的。Links對(duì)象是超媒體之外的另一個(gè)選擇，它是靜態(tài)的，而超媒體是動(dòng)態(tài)且自文檔（self-documenting）的，Ratovsky說(shuō)，“我們想著該如何提供一個(gè)方案，最后我們把它定義為靜態(tài)的。我們希望得到更多有關(guān)Links這一特性的反饋。我們希望能夠擴(kuò)展這一特性，并為超媒體帶來(lái)更多的可能性。”

除了Links對(duì)象，TDC成員希望能夠得到更多其他方面的反饋。與其他開(kāi)源項(xiàng)目一樣，OAS也依賴(lài)社區(qū)的支持和參與。“我們依賴(lài)社區(qū)的努力——特性請(qǐng)求、發(fā)表意見(jiàn)、拉取請(qǐng)求”，Ratovsky說(shuō)，“我希望能夠收到更多來(lái)自產(chǎn)品經(jīng)理、QA工程師、技術(shù)作者和API生命周期相關(guān)人員的反饋。我們想知道OAS要怎樣才能讓他們的工作變得更美好。”

用戶(hù)可以在OAS的GitHub倉(cāng)庫(kù)里找到如何參與項(xiàng)目的相關(guān)信息。SmartBear將在8月9號(hào)舉辦一個(gè)webinar，對(duì)實(shí)現(xiàn)新特性感興趣或正在從Swagger 2.0遷移到OAS 3.0的人可以關(guān)注下。

查看英文原文：The Open API Initiative Announces the OpenAPI Specification 3.0.0