将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. 在左上角，选择文件 - ＆gt;导入文件...指向您在步骤＃1中导出的本地Swagger JSON文件，以在Swagger编辑器中打开
4. 选择生成客户端 - ＆gt;菜单中的Swagger YAML选项
5. 它将生成您可以在http://www.yamllint.com/站点
验证的YAML

Answer 2

转换

如果您希望从任何版本的Swagger转换为RAML 0.8，那么APITransformer.com可以为您完成。我们几乎完成了RAML 1.0导出。将在一周内发布。

验证

转换后的描述来自APIMatic在生成SDK /客户端库之前用于验证API描述的相同代码引擎。因此，默认情况下将验证转换后的RAML。

还可以通过APIMatic's CLI或APIMatic's API

验证各种格式的API说明

Answer 3

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

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

Answer 4

其实非常简单

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

  

注意：存在将JSON转换为YAML，但不存在JSON到RAML

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

您下载的JSON的YAML版本将被下载。

Answer 5

虽然我希望有一个命令行工具，但该公司似乎已经制作了一个转换器：

https://apitransformer.com/