将Swagger JSON转换为RAML/YAML

Question

如何将Swagger JSON转换为RAML/YAML并进行验证？我不是在寻找一种程序化的方式,只需要一次转换.

Answer 1

以下是步骤:

1. 将Swagger JSON导出到驱动器上的文件中.此JSON应在您的服务器上以下列URI发布:/ swagger/docs/v1
2. 转到http://editor.swagger.io/#/
3. 在左上角,选择文件 - >导入文件...指向您在步骤#1中导出的本地Swagger JSON文件,以在Swagger编辑器中打开
4. 从菜单中选择Generate Client - > Swagger YAML选项
5. 它将生成您可以在http://www.yamllint.com/ site 验证的YAML

Answer 2

其实很简单

Web 版本的swagger 编辑器可以灵活地导入现有的 swagger 文件（JSON/YAML）并下载当前显示的配置文件。所以只需将这两者结合起来即可。

注意：存在将 JSON 转换为 YAML 的功能，但不存在将 JSON 转换为 RAML 的功能

1. 首先在http://editor.swagger.io/#/ 导入 swagger JSON （文件 > 导入文件）
2. 看到配置后，只需下载相应的 YAML 版本（文件 > 下载 YAML）。

将下载您刚刚上传的 JSON 的 YAML 版本。

Answer 3

要在各种格式（例如 Swagger/OpenAPI、RAML、Postman 等）之间转换 API 规范，您可以使用以下免费开源工具：

• https://github.com/lucybot/api-spec-converter
• https://github.com/stoplightio/api-spec-converter