OpenAPI 規(guī)范 3.1.0 發(fā)布，趕緊來嘗嘗鮮！
我們常說，新年新氣象！這不，剛開年，各大廠商就忙著發(fā)布自己的最新產(chǎn)品。
Spring Boot發(fā)布了最新的2.4.3版本，昨天小編剛為大家介紹過，有興趣的小伙伴點(diǎn)這里：Spring Boot 2.4.3、2.3.9 版本發(fā)布，你準(zhǔn)備好了嗎？
除了Spring Boot，OpenAPI也在近日正式發(fā)布了其最新的3.1.0版本規(guī)范。
OpenAPI 規(guī)范是用于描述 API 的行業(yè)標(biāo)準(zhǔn)，它允許開發(fā)人員和計(jì)算機(jī)在不需要訪問源代碼、文檔或網(wǎng)絡(luò)流量的情況下理解 API 的功能。
本次更新是在3.1.0-rc1版本的基礎(chǔ)上進(jìn)行進(jìn)一步突破性的優(yōu)化，讓我們一起來看看吧。
新增內(nèi)容
添加了jsonSchemaDialect頂級字段，以允許為模式對象定義默認(rèn)的$schema值。
更新內(nèi)容
更新了一些鏈接到更準(zhǔn)確的位置。 將JSON模式支持更新為最新的2020-12草案。 修改了uri和url下的相對引用解析。 修改了文件上傳描述，以考慮新的JSON模式功能。這包含了一些突破性的變化。 規(guī)范擴(kuò)展的x-oai和x-oas前綴現(xiàn)在都保留由OpenAPI進(jìn)行定義。
一些解釋內(nèi)容
路徑參數(shù)值不能包含未轉(zhuǎn)義的字符/，？或#。
進(jìn)一步解釋應(yīng)該在何處使用引用對象和JSON模式的引用。
統(tǒng)一當(dāng)值為URLs/URIs時(shí)的用法。
重寫路徑項(xiàng)的$ref以考慮引用和組件更改。
修正了一些例子。
微小的文本更改，以提高一致性和可讀性。
更新引用對象的描述用來進(jìn)一步闡明其行為意義。
進(jìn)一步更新了Schema對象的描述，以考慮最新的draft和默認(rèn)使用https://spec.openapi.org/oas/3.1/dialect/base作為OAS方言。
將“Schema Vocabularies”改為“Schema dialects”。
具體內(nèi)容可查看：https://github.com/OAI/OpenAPI-Specification/releases/tag/3.1.0
看完更新內(nèi)容，小伙伴們是不是蠢蠢欲動，迫不及待體驗(yàn)最新版本的變化呢？也歡迎各位小伙伴將自己對本次更新的內(nèi)容看法留言進(jìn)行討論！
往期推薦
