RAML 文件的验证

Posted 2023-02-19

【中文标题】RAML 文件的验证

【英文标题】：Validation of RAML file

【发布时间】：2018-03-17 07:04:31

【问题描述】：

假设我们有一些 Swagger 2.0 文档，例如 http://petstore.swagger.io/v2/swagger.json

我正在尝试使用 Apimatic 将其转换为其他格式。 https://apimatic.io/transformer

如果我将 Petstore Swagger 文档转换为 WADL，结果似乎无效。 我已经针对 WADL 文件进行了验证 https://www.w3.org/Submission/wadl/wadl.xsd

通常，我需要将 Swagger 转换为 WADL 或 RAML。 我正在尝试使用 Apimatic 作为替代方案从 Swagger 转换为 RAML，因为转换为 WADL 不起作用。

有没有办法（在线或离线工具）检查生成的 RAML 文件是否有效？

谢谢。

【参考方案1】：

在线：https://anypoint.mulesoft.com“设计中心”

离线：转到https://raml.org/projects 并单击“设计”选项卡

同样在后者中检查“实用程序”选项卡，那里有 swagger to RAML 转换器。

【讨论】：

对于像验证 RAML 文件这样简单的任务来说，这似乎有点过头了。输入是 RAML 文件（可能无效）。输出应该是一个布尔值：有效/无效。如果无效，带有验证错误的字符串消息会很好。请提供明确的说明如何使用 API Manager 实现此目的。

不知道有这样的在线工具。 raml.org 项目页面上的解析器正是这样做的，它们将解析您的 RAML 并给出验证错误，如何使用取决于您选择的。对于 API Manager：1）您注册，2）您添加一个新 API，3）打开设计器，4）粘贴您的 RAML，5）查看它是否有验证错误......（如果它加载图形视图它没有）

说实话，我还是迷路了。我已经注册，添加了一个新的 API ......但不知道设计师在哪里。我已经上传了截图。 uschovna.cz/en/zasilka/QR5GI7HR43ANB9R8-74X

是的，很抱歉，我在该屏幕上看到了“API 设计器”部分，不知道为什么与您的不同。我再次检查了注册，现在您必须转到“设计中心”（从左上角菜单）并创建 API 规范。