问题标签 [raml]

我正在寻找如何为对象中的对象集合编写 JSON 模式。

我们有一个表格，其中有一个用于科学应用程序的长段落，其中包含符号 beta(ß-arrestin) 等字符。我们有一个在 Mule 上运行的 JSON 服务，它获取数据并保存到 Oracle 数据库。这个带有长段落的特定元素在 RAML/JSON 中给了我一个错误。下面是错误

科学家们编写的表单元素我们无法控制。因此，在 Mule 方面，我们如何像 java 具有 URLEncoded 一样自动转义这些字符。非常感谢

我刚刚了解了RAML - RESTful API 建模语言，它似乎非常有用。我有一些返回 json 的端点。是否有任何工具或代码可以从一个或多个示例 JSON 响应生成 RAML ？

我见过从 RAML 生成的工具，但没有一个工具可以创建 RAML 本身。我的主要动机只是为我的所有端点快速启动并运行 RAML，这会有点繁琐（而且我们是程序员，所以我们当然要自动化它）。

1) 在编写 RAML 时，我可以在架构定义中使用嵌套吗？

例如：

2) 我可以围绕一组可嵌套模式使用选择/枚举吗？

我已经通过 API 控制台启用了 mule mock 服务。我的获取请求工作正常，但不是 POST - 给出 404；我正在通过“try it”控制台进行测试，所以 API def. 存在：

任何已知问题 - 还是我做错了什么？

更新 - 现在得到 500 响应：

URL 看起来很狡猾，就像涉及到代理一样；但我已经关闭了 Anypoint 配置中的代理。

即使我从邮递员直接发布到模拟 URL，我也会收到一个空响应错误

我想了解使用 RAML 对资源进行操作建模的最佳方法是什么。

例如，我在 RAML 中有以下资源定义：

现在对于一个订单，我想模拟一个“批准”动作。是否有使用 RAML 执行此操作的最佳实践？

我喜欢 RAML 在声明 resourceType 时如何动态引用不同的模式，例如：

在这里我可以像这样使用

RAML 会给我user来自 GET 和 POST 的模式响应，并使用userCreate模式发送 POST 请求。凉爽的！现在我可以用大量不同的模式重用我的集合定义。

但是现在我也想为所有内容提供示例 json，我希望以<<schema>>另一种方式利用 var 来利用“代码重用”。我希望能够做到

但不幸的是，这不起作用。我收到一条错误消息

所以现在我不得不手动将它添加到我所有的收藏中，/users上面的例子变成了

对我来说，这只是添加示例的大量开销。尤其是当我想在许多资源上重复该模式时。

问题：有没有办法做到这一点？

我正在使用 RAML 对 API 进行建模，我想知道是否可以对查询参数之间的依赖关系进行建模。

假设我们有一个对象集合。用户可以通过指定对象类型和状态来缩小查询结果的范围。这里有一点 RAML 应该做我刚才说的：

现在上面的定义可能会让用户觉得可以使用他们想要的任何组合 - 不太正确的地方，如：
- 'Type1' 的对象可以只取 'State1'，
- 'Type2' 的对象可以取 'State2'和 'State3',
- 'Type3' 的对象可以采用 'State1'、'State2'、'State3'。

有谁知道如何用 RAML 建模？

我正在尝试使用 raml2code ( https://github.com/gextech/raml2code ) 从 .raml 文件生成代码。

不幸的是，描述不是很好，我不知道该怎么做。

谁能给我举个例子？

刚开始使用 raml（阅读规范），看看它是否有我需要记录我的 api 的东西。

关注根级别所需的 baseUri 属性来定义您的服务器 URL。我在一个场景中，我的 api 在许多不同的域中提供。

是否可以将 baseUril 定义为提供 raml 文档的 url？

只看规格，我没有看到办法。当然，我可能有多种方法可以在部署之前清理 raml 文档，或者包含正确的域 raml 文件，该文件具有为该特定部署定义的变量。但我真的很想避免这种情况。