问题标签 [raml]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
1135 浏览

swagger - RAML 资源类型和特征 VS Swagger $ref

我真的很喜欢 RAML 如何通过使用 ResourceTypes 和 Traits 专注于减少重复数量并提高 API 之间的一致性。

但是在仔细查看 Swagger 规范之后,您似乎可以通过使用 $ref 来完成同样的事情。

在这种情况下,RAML 是否比 $ref 更有优势?我错过了什么吗?

0 投票
1 回答
282 浏览

swagger - 是否可以从 Swagger 和/或 RAML 导入和/或导出 API 蓝图?

是否可以在任何格式之间架起桥梁?谢谢你。

0 投票
0 回答
120 浏览

oauth-2.0 - OAuth 2.0 规范 itsetlf 的 RAML 文件(不是使用 OAuth 的 API)

OAuth 规范本身是否有 RAML 文件?我看到许多在 RAML 中定义的使用 OAuth 的 API 示例,但我很好奇是否有一个可以定义 OAuth 授权服务器本身。

0 投票
1 回答
539 浏览

swagger - 是否有公共 API Swagger 定义库?

因此,我一直在构建一个利用网络上流行的 API 的服务,我发现 Swagger 是该项目的一项巨大资产。我无需编写大量难以维护的自定义代码,而是能够使用 Swagger 定义动态创建对我们服务支持的公共 API 的所有请求。

这已经运行了大约 1 年,但我们希望继续向我们的平台添加服务,最终我们用一个维护负担换了另一个。虽然有很多公共 API,但其中没有多少能很好地封装在 Swagger 等计算机可消耗的形式中。

我想知道是否有人知道 Internet 上存储 Swagger、RAML、API 蓝图等库的中心位置。

如果这样的东西还不存在,它可能应该存在。

0 投票
1 回答
294 浏览

java - 在进行 WSDL 到 RAML 迁移时,如何确定 RAML(REST API)的 HTTP 动词?

我正在尝试创建一个 WSDL 到 RAML 转换器。在最初的分析过程中,我偶然发现了一个问题,即决定每个 WSDL 操作在 RAML 中的 REST api 表示应该使用什么HTTP 动词(PUT、POST、GET、DELETE) 。

我不能提出一种基于 WSDL 操作来识别 HTTP 动词的模式,因为没有关于 WSDL 操作命名约定的特定标准\指南。

谁能建议我可以将 WSDL 操作映射到 HTTP 动词的选项?

问候阿伦

0 投票
1 回答
1095 浏览

facebook - 机器可读格式的 Facebook API

在哪里可以找到http: //swagger.io、https : //apiblueprint.orghttp://raml.org等格式的 Facebook API ?

我想阅读并请求 facebook 服务器(api)“半原子”。我的脚本知道如何与 facebook 服务器交互。这就是为什么我需要机器可读格式的 Facebook API。

谢谢你的任何提示。干杯托拜厄斯

0 投票
1 回答
1960 浏览

json - 为获取/发布的动态键/值创建 RAML 文件

我正在使用 Mule 应用程序从另一个系统获取数据,该系统由 HTTP 端点调用,使用 java 和 jersey api 来获取其余组件。

下面给出了示例输入数据,这里的键和值不是固定的,可能会根据用户要求而有所不同。数组大小可能会增加 2 到 n 个条目。它适用于 Mule 和基于 Java 的 rest 组件。

输入 JSON 数据:

计划使用 RAML 迁移到 APIkit:如何为上述案例制作 RAML 模板?由于键是动态的,这似乎并不简单。

2) 使用相同的 GET 方法,我将为我的 get 请求获取数据,我不确定密钥及其对应的值是什么,我所做的只是获取数据,解析它并将其发送给用户。在这种情况下如何创建 RAML 模板。带有 RAML 的 mule APIkit 是否可以在这里工作?

我现有的代码:

0 投票
2 回答
1483 浏览

mule - Mule esb:验证 .raml 文件中的数组项

我的 .raml 文件中有以下 json 模式定义

当数组中的必填字段之一丢失时,我需要 mule ESB 拒绝输入。

例如,这应该被 400-BAD REQUEST 拒绝:

如果架构不在数组中,则验证工作正常。但是当在数组内部时,它不会验证任何具有所需属性的单个项目。

我需要特殊配置吗?

谢谢。

0 投票
4 回答
1355 浏览

raml - RAML API Designer 文件保存位置

我刚刚开始玩 RAML。我在本地运行API 设计grunt server器,并用它在 RAML 中设计了一个简单的 api 文档。

该文件是否raml保存在本地文件系统中?我在本地文件系统中找不到该文件的保存位置。我需要那个文件,因为我必须提交它 GIT 存储库。

0 投票
0 回答
455 浏览

json - RAML API Designer 模拟服务:带有绝对 URL 的 HATEOAS 响应?

我使用 RAML 工具创建了 REST API 模拟。如何在我的 JSON 对象响应超媒体链接中返回绝对路径?
有没有办法将baseUri包含到我的示例 JSON 对象中以创建绝对路径?

现在我"/users/ff33c2a1-b877-4415-9e62-115b8239c787"的 JSON 对象中有相对路径:

实际上我想要从我的baseUri值中获取根的绝对路径。

例如路径应该是这样的"http://mocksvc.mulesoft.com/mocks/a2683439-a5dc-409c-801a-c771042970fb/mocks/31e46658-b4ce-4f40-cc91-c4fd50f7a2d8/v1/users/ff33c2a1-b877-4415-9e62-115b8239c787"

我尝试使用类似的东西:

"href": "{baseUri}/users/ff33c2a1-b877-4415-9e62-115b8239c787"

或不带引号

"href": {baseUri}/users/ff33c2a1-b877-4415-9e62-115b8239c787

但以上都没有奏效。

我正在使用RAML 0.8