资源建模语言 RAPID-ML 的创建者 RepreZen 推出了面向 Swagger API 描述语言(即现在众所周知的开放 API 规范(OAS))的 KaiZen OpenAPI 编辑器和 KaiZen OpenAPI 解析器,当前支持的版本是 2.0,3.0 的支持有望在 2017 年 7 月发布。
KaiZen 编辑器之前称为 SwagEdit,它提供了一种编辑开放 API 描述的原生 IDE 体验,以及语法高亮、大纲导航、本地文件系统访问、内置版本控制、自动构建系统等基本特性。KaiZen 解析器提供了高性能的开放 API 描述解析和验证,并提供了 JSON 和 YAML 序列化支持。两者都可以通过 Eclipse Marketplace 获得。 RepreZen API Studio 对 OAS 2.0 和 3.0 编辑提供了实验性支持,而在 Eclipse IDE 中有一个插件可用。
KaiZen 是由 RepreZen 过去两年所参与的 Swagger(现在的开放 API)社区开发出来的,近日,他们加入了开放 API 倡议。在 OAS 3.0 支持方面,该项目是社区最早的贡献之一,实际上可能是第一个兼容 OAS 3.0 的编辑器。
开放 API 倡议在 Linux 基金会的开放治理之下。OAS 是一个供应商中立的 REST API 标准描述格式,最初源于 Swagger 规范。3.0 版本尚未正式发布,当前的规范草案还要等待2017 年6 月19 日到30 日之间的一个评论期,最终的规范会在2017 年7 月发布。规范的重大变化包括更全面地支持JSON Schema、改进结构和文档、引入回调及Links 组件,迈出了支持超媒体的第一步。发表在博客Readme.io 上的图解指南通过例子说明了这些变化,并通过框图对比了Swagger 2.0 和Open API 3.0 包含的组件。
在OAS 3.0 的扩展组件和新特性中,最让RepreZen 首席执行官Ted Epstein 兴奋的是新的回调组件。他在接受InfoQ 采访时说,“它开启了服务与客户端双向通信的理念,也就是说,两者之间的差别比以前小了。”除了可以更好地重用响应体定义和安全模式外,这提高了代理包含客户端和服务的异步解决方案的能力,为标准和协作提供了新的可能,而这在以前并不容易。
随着新版本即将最终定稿,开发人员可以期待KaiZen 及其他工具会随着生态系统的发展对2.0 版本提供持续的支持。之前企业向社区提供的支持2.0 版本的贡献包括 IBM 的 API 微网关和 MuleSoft 的 API 建模框架,这对规范的开源支持是一个广泛的补充。RepreZen 加入开放API 社区是API 行业围绕OAS 发展整合的又一项举措。
查看英文原文: RepreZen Releases KaiZen Open-Source Editor and Parser for Open API 3.0
评论