OpenAPI规范3.1.0发布!可以为架构扩展引入一种新的标准化方法

   网安盾        

2月19日消息,OpenAPI倡议是由前瞻性行业专家组成的联盟,专注于创建、发展和推广OpenAPI规范(OAS),这是一种面向HTTP(包括RESTful)API的厂商中立、开放的描述格式,今天宣布OpenAPI规范3.1.0已经发布。这个新版本现在支持100%兼容JSON Schema的最新草案(2020-12)。


OpenAPI规范3.1.0发布!可以为架构扩展引入一种新的标准化方法


在发布这个版本的同时,OpenAPI倡议还赞助创建了新的文档,使其更容易理解规范的结构及其好处。


OpenAPI规范是一个广泛采用的描述现代API的行业标准。它为HTTP API定义了一个标准的、与编程语言无关的接口描述,允许人类和计算机发现和理解服务的功能,而不需要访问源代码、额外的文档或检查网络流量。


OpenAPI规范(OAS)被世界各地的组织使用,包括Atlassian、Bloomberg、eBay、Google、IBM、微软、Oracle、Postman、SAP、SmartBear、Vonage等。


"使用OpenAPI规范的好处是广泛适用的,从API生命周期管理,到文档,到安全,再到微服务开发,还有很多很多。"谷歌产品经理、OpenAPI倡议技术指导委员会Marsh Gardiner说。


"在演进到3.1.0版本时,我们非常谨慎,以确保它是现有用户的增量升级,同时也使其成为企业环境中立即评估和采用的优秀候选者。我们向不同的贡献者群体表示衷心的感谢,感谢他们为我们的最新成就所付出的所有卓越技能和努力。"


"OpenAPI JSON Schema类结构和JSON Schema本身之间的不匹配长期以来一直是用户和实施者的问题。OpenAPI 3.1.0与JSON Schema草案2020-12的完全一致,不仅可以为用户省去很多痛苦,而且还将迎来一种新的模式扩展的标准化方法。"JSON Schema项目负责人Ben Hutton说。


"在过去的几年里,我们花了很多时间(和发布)来确保我们能够清楚地听到和理解社区所面临的问题。通过我们基于志愿者的有限时间的努力,我们不仅修复了许多痛点并增加了新功能,而且JSON Schema词汇表允许定义标准,这些标准迎合了验证之外的用例,如代码、UI和文档的生成。


OpenAPI规范3.1.0发布!可以为架构扩展引入一种新的标准化方法


在JSON Schema草案2020-12发布的第一天,就准备好了两个实现。能与这样一个经验丰富、技术精湛的团队合作,我感到很惭愧。"


虽然JSON Schema在技术上仍然是一个 "草案 "规范,但2020-12草案设置了一个新的稳定基础,第三方可以在此基础上建立标准化的扩展。JSON Schema团队预计不会对扩展系统的方法进行任何重大改变,比如方言和词汇表。然而,随着收到反馈,实用性可能会得到改进。

最新评论(0)条评论
不吐不快,我来说两句

还没有人评论哦,抢沙发吧~

相关新闻推荐