【IT168 资讯】开放API计划是为推进API技术而开发的Linux Foundation项目,已经达到了新的里程碑。 经过近两年的工作,3.0版终于完成。该版本的亮点之一是,它能够驱动完整的API生命周期,但还有很多新的更新和功能值得注意。
Open API Initiative(OAI)于2015年11月发布。SmartBear Swagger Products副总裁Tony Tam在一篇博文中写道,SmartBear软件已经在Linux基金会下组织开放了API计划,并且捐赠了Swagger规范。
OAI集团将以开放和协作的方式帮助演进规范,坚持一套简短而重要的核心价值观—开放,协作,贡献驱动,务实,可扩展,稳定和中立。
OpenAPI规范3.0
OAS 3.0基于原始的Swagger 2.0规范,旨在提供一种统一行业定义和描述RESTful API的标准格式,OAS 3.0的发布标志着API经济增长的一个重要里程碑—汇集了来自不同行业的合作者,以开放透明的方式发展规范,以满足全球API开发人员和消费者的需求。
以下是此版本包含的一些更新和功能:
·规范的整体结构被重构以获得更好的可重用性
·添加了描述回调的支持
·链接以表达操作之间的关系
·JSON模式包括对oneOf,anyOf的支持
·改进的参数描述,包括使用模式的能力
·支持多部分文档处理
·新增Cookie参数; 去掉dataForm参数
·Body参数有自己的实体
·支持内容类型协商
·安全定义已被简化和增强
第三代规范的发布是社区的重要里程碑,所做的更新完全是用户使用和驱动的,并且在规范中起了巨大作用。该版本最强大的一个功能就是驱动整个API生命周期。OpenAPI 3.0的新资源和文档将在未来几周内推出。