BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

OpenAPI规范3.0版接近最终发布

| 作者 Abel Avram 关注 10 他的粉丝 ,译者 Rays 关注 3 他的粉丝 发布于 2017年2月4日. 估计阅读时间: 2 分钟 | QCon上海2018 关注大数据平台技术选型、搭建、系统迁移和优化的经验。

“开放API战略”(Open API Initiativev) 发布了OpenAPI规范3.0版的预览,并规划于今年二月底发布实施草案(Implementer Draft)。

新的OpenAPI规范3.0带来了如下重大改进

  • 为实现更好的可重用性,对规范的整体架构进行了重构,重构后的架构如下图所示。
  • 支持oneOf、anyOf和not的JSON模式。
  • 可使用模式的参数。
  • 引入了Cookie参数,去除了dataForm参数。
  • 具有自身实体的主体参数(Body Parameter)。
  • 可协商的内容类型。
  • 多主机支持。
  • 简化了安全定义,改进的WebHooks不再通过回调机制描述。

“开放API战略”作为负责规范开发的组织,计划在今年二月底前给出首个实施草案。

已公布的OpenAPI规范目标是:

定义标准的、独立于语言的指向REST API的接口,使得服务能力无需访问源代码、文档,或是借助于网络流量检查,就可被人类和计算机发现并理解。通过对OpenAPI做适当定义后,消费者可使用最小数量的实现逻辑理解远程服务,并与远程服务交互。

OpenAPI基于Swagger 2.0构建,Swagger是SmartBear贡献给Linux基金会的。意在构建具有中立管理模型的新组织,以引领Swagger更上一层楼。“开放API战略”的创始成员包括对贡献具有兴趣的Google、IBM和Microsoft。同时还成立了一个技术开发者社区(TDC,Technical Developer Community)以对规范做开发。TDC对于任何有意向做出贡献的个人都是开放的,无需会员身份。

在对“上百个任务单和上千条评论”近一年的处理工作后,现在OpenAPI规范已接近于最终发布,不会再有任何其他重大改进。

查看英文原文:The OpenAPI Spec Reaches 3.0


感谢刘志勇对本文的审校。

给InfoQ中文站投稿或者参与内容翻译工作,请邮件至editors@cn.infoq.com。也欢迎大家通过新浪微博(@InfoQ@丁晓昀),微信(微信号:InfoQChina)关注我们。

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

早该出来了 by 冯 光头

虽然不明白,但是感觉很厉害 by Wong Peter

rt

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

2 讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT