OpenAPI 规范 (OAS) 版本 2.0(以前称为 Swagger 规范)是当前 API 描述的行业标准,得到了数千个开源项目和所有主要 API 技术供应商的支持。而 OAS 版本 3.0,计划于 2017 年 7 月发布,是该规范的首次重大更新。
OpenAPI 3.0 可以用更高的精度和细节描述更广泛的现代 REST API。它提供了改进的组件重用、更灵活的消息模式以及新的 API 功能,如超链接和回调。
RepreZen 很高兴地宣布,我们的商业和开源软件中已提供对 OpenAPI 3.0 的实验性编辑支持,将这些新功能带到开发人员的桌面。我们的第一个实现基于当前的 草案规范,并使用 Gnostic OpenAPI JSON 模式,由 Google 的 Tim Burks 贡献。
RepreZen 加入 Open API Initiative
我们还很荣幸地宣布 RepreZen 现在是 Open API Initiative 的成员,我们将继续作为技术开发者社区的一部分,参与 OpenAPI 规范的工作。
与 OpenAPI 社区合作对我们来说是一次令人满意的经历,因为 SmartBear、Google、Microsoft 等公司拥有丰富的知识和思想领导力。他们兑现了保持该组织开放和供应商中立的承诺。并且通过 Swagger,他们继承了大量的实践知识,这些知识在 GitHub(和其他地方)的讨论线程中详细阐述,并提炼到 OpenAPI 规范 本身。
对于 RepreZen 团队来说,这正式认可了我们多年来的参与,以及我们对 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 版或更高版本)中进行试用。安装完成后,请查看 入门指南 以快速了解概况。