RepreZen 发布面向 Open API 3.0 的 KaiZen 开源编辑器和解析器

  • Shelby Switzer
  • 谢丽

2017 年 6 月 22 日

话题:语言 & 开发

资源建模语言 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

语言 & 开发