OpenAPI 规范 (OAS) 版本 2.0(以前称为 Swagger 规范)是当前 API 描述的行业标准,得到数千个开源项目和所有主要 API 技术供应商的支持。OAS 版本 3.0,计划于 2017 年 7 月发布,是该规范的第一个重大更新。
OpenAPI 3.0 可以更精确、更详细地描述更广泛的现代 REST API。它提供了改进的组件重用、更灵活的消息模式以及新的 API 功能,如超链接和回调。
RepreZen 很高兴宣布在我们的商业和开源软件中对 OpenAPI 3.0 提供实验性编辑支持,将这些新功能带到开发人员的桌面上。我们的第一个实现基于当前的 草案规范,并使用 Google 的 Tim Burks 贡献的 Gnostic JSON Schema for OpenAPI。
RepreZen 加入 OpenAPI 倡议
我们还很自豪地宣布,RepreZen 现在是 OpenAPI 倡议 的成员,我们将继续作为技术开发人员社区的一部分,参与 OpenAPI 规范的制定。
与 OpenAPI 社区合作对我们来说是一次令人满意的经历,因为 SmartBear、Google、Microsoft 等公司拥有深厚的知识和思想领导力。他们信守了保持小组开放和供应商中立的承诺。借助 Swagger,他们继承了丰富的实践知识,这些知识体现在 GitHub(和其他地方)的讨论线程中,并被提炼到 OpenAPI 规范 本身。
对于 RepreZen 团队来说,这正式证明了我们参与 OpenAPI 的时间已经长达数年,并且我们支持 OAS 作为行业标准的 API 描述语言。
对我们的客户而言,加入 OAI 是我们对继续将 OAS 放在 RepreZen 产品和开源技术核心位置的承诺,以不断创新并构建使 OpenAPI 对您起作用的解决方案。
关于 OpenAPI 的过去和未来
优秀的软件在于折中。
如果您像我一样是一个有想法的人,您会从抽象的角度出发,用最大的洞察力和最少的实现细节来描述问题的本质和解决方案。您会寻找最高级、最具表现力的方式以机器可读的形式来表示它,您会深入到实现细节,但只到您需要为止。
如果您是一个务实主义者,您会从基础开始,从机制开始,并逐步重构到更优雅的解决方案。但这只有在优雅性能够带来回报的情况下才会发生。然后您就会停止,将粗糙的边缘留到以后再处理,然后继续前进。
但是,无论您从哪个角度出发,这都是一个持续的协调过程。软件的演进意味着概念框架和代码的同步演进;并且持续不断地、巧妙地将它们编织在一起。您自上而下和自下而上地工作,并在中间相遇。
OpenAPI 规范是一个很好的例子,说明了恰到好处的抽象能够发挥的作用。它提供了表达能力的提升,使开发人员能够以资源、操作和数据模型(熟悉的概念)为单位进行思考,这些概念在协议、控制器和类的大树上空舒适地滑翔。您无需以高级语义、深奥的概念或宗教教条重新思考您的 API。
借助丰富的商业和开源工具生态系统,开发人员可以选择自下而上地工作,使用代码优先注释,或者自上而下地工作,使用 API 描述语言。无论您从哪里开始,我们都可以使用 OpenAPI 规范在中间相遇。
让我们谈谈 API!
想要参与?我们的门是敞开的,我们很乐意听到用户的反馈。
- 联系我们,让我们知道您对 OpenAPI、RepreZen API Studio 和 KaiZen Editor 的看法。
- 发布问题 在 GitHub 上针对 KaiZen OpenAPI Editor,或访问我们的 支持和社区网站 了解 RepreZen API Studio
- 如果您想为 KaiZen Editor、KaiZen Parser 或我们的其他 开源项目 贡献改进,请发送电子邮件至 [email protected]。我们欢迎认真的代码贡献。
Reprezen API Studio:用于 OpenAPI 开发的完整 IDE
RepreZen API Studio 是我们面向 API 首选设计、文档和开发的旗舰平台。
要开始使用,只需 注册免费试用版,下载并安装。请参阅我们支持网站上的 常见问题解答文章 以开始使用。
KaiZen OpenAPI Editor:现已在 Eclipse 市场中发布
KaiZen OpenAPI Editor 是 RepreZen 基于 Eclipse 的开源编辑器,用于行业标准的 OpenAPI 规范语言。这是 RepreZen API Studio 使用的同一个功能齐全的编辑器,以前称为 SwagEdit。KaiZen OpenAPI Editor 是我们用于 OpenAPI 2.0 和 3.0 的核心编辑组件。
您可以通过从 Eclipse 市场 安装到 Eclipse 桌面 IDE(Mars.2 版本或更高版本)来试用它。安装完成后,请参阅 入门指南 以快速了解概览。