33

如何将 Swagger JSON 转换为 RAML/YAML 并对其进行验证?我不是在寻找一种程序化的方式,只是一种一次性的转换。

4

5 回答 5

39

以下是步骤:

  1. 将 Swagger JSON 导出到驱动器上的文件中。此 JSON 应在您的服务器上以以下 URI 发布:/swagger/docs/v1
  2. 转到http://editor.swagger.io/#/
  3. 在左上角,选择 File-> Import File... 指向您在步骤 #1 中导出的本地 Swagger JSON 文件以在 Swagger Editor 中打开
  4. 从菜单中选择 Generate Client -> Swagger YAML 选项
  5. 它将生成您可以在http://www.yamllint.com/站点验证的 YAML
于 2015-09-23T02:55:04.373 回答
4

转换

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

验证

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

各种格式的 API 描述也可以通过APIMatic 的 CLIAPIMatic 的 API进行验证

于 2016-10-23T01:40:15.853 回答
4

要在各种格式(例如 Swagger/OpenAPI、RAML、Postman 等)之间转换 API 规范,您可以使用以下免费和开源工具:

于 2016-12-06T14:53:02.583 回答
4

其实很简单

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

注意:存在将 JSON 转换为 YAML,但不存在将 JSON 转换为 RAML

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

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

于 2017-10-23T11:42:36.203 回答
0

虽然我希望有一个命令行工具,但这家公司似乎做了一个转换器:

https://apitransformer.com/

于 2016-08-24T17:32:10.160 回答