【发布时间】:2015-12-20 05:15:50
【问题描述】:
如何将 Swagger JSON 转换为 RAML/YAML 并进行验证?我不是在寻找一种程序化的方式,只是一种一次性的转换。
【问题讨论】:
标签: json api yaml swagger raml
如何将 Swagger JSON 转换为 RAML/YAML 并进行验证?我不是在寻找一种程序化的方式,只是一种一次性的转换。
【问题讨论】:
标签: json api yaml swagger raml
其实很简单
swagger editor 的 Web 版本提供了导入现有 swagger 文件 (JSON/YAML) 和下载当前显示的配置文件的灵活性。所以只需将这两者结合起来。
注意:存在将 JSON 转换为 YAML,但没有将 JSON 转换为 RAML
您刚刚上传的 JSON 的 YAML 版本将被下载。
【讨论】:
要在各种格式(例如 Swagger/OpenAPI、RAML、Postman 等)之间转换 API 规范,您可以使用以下免费和开源工具:
【讨论】:
转化
如果您希望将任何版本的 Swagger 转换为 RAML 0.8,那么 APITransformer.com 可以为您完成。我们几乎完成了 RAML 1.0 导出。一周后会发布。
验证
转换后的描述来自 APIMatic 用于在生成 SDK/客户端库之前验证 API 描述的同一代码生成引擎。因此,默认情况下将验证转换后的 RAML。
还可以通过APIMatic's CLI 或APIMatic's API 验证各种格式的API 描述
【讨论】:
虽然我希望有一个命令行工具,但这家公司似乎做了一个转换器:
【讨论】:
步骤如下:
【讨论】: