在线提供示例 RAML [关闭]

Posted 2023-02-19

【中文标题】在线提供示例 RAML [关闭]

【英文标题】：Sample RAMLs available online [closed]

【发布时间】：2015-12-16 05:52:06

【问题描述】：

我想知道是否有任何公开可用的 API 记录在 RAML 中。

我有这两个工作正常：

https://raw.githubusercontent.com/raml-org/raml-tutorial-200/step8/jukebox-api.raml

http://api-portal.anypoint.mulesoft.com/onpositive/api/gmail-raml-api/gmail.raml

这 3 个由于某种原因无法正常工作：

http://api.apihub.com/onpositive/api/espn-raml-api/espn.raml>> *** question

http://api-portal.anypoint.mulesoft.com/github/api/github-api-v3/github-api-v3.raml

http://api-portal.anypoint.mulesoft.com/instagram/api/instagram-api/instagram-api.raml

有人可以帮我吗？

【问题讨论】：

您的意思是您想要一些 RAML 文件的公共示例吗？ “不工作”是什么意思？

在 java 解析器验证中，这 3 个都失败了。

不确定您要在这里实现什么。如果您担心解析器中的问题，请针对收到的违规问题提出一个新问题，以便我们讨论发生了什么。

我只是通过读取 raml 创建休息服务元数据 xml。在这样做的同时，我计算出了一些问题。请在下面找到问题***.com/questions/32570593/…

【参考方案1】：

这里还有一些有效的 RAML https://github.com/mulesoft/api-console/tree/master/dist/examples

【讨论】：

只有raw.githubusercontent.com/mulesoft/api-console/master/dist/… 为我工作。你确定这些应该开箱即用吗？

是的，您需要使用原始版本 - 否则无法正常工作。

【参考方案2】：

我知道的一些有效的 RAML 规范：

https://github.com/openanalytics/RPooli/blob/master/webapp/src/main/webapp/raml/api_v1.raml https://api.unbounce.com/raml/v0.4/api.raml

【讨论】：

嗨，大卫，第二个看起来不错，验证成功通过。但第二个给了我“这里不允许映射值”错误。这是为什么？？谢谢，

两者都在生产中使用并被 RAML 测试器和 API 控制台等工具使用，所以这很奇怪。无论如何，我不清楚您报告的内容：是第二个给出此错误的第一个吗？

抱歉打错了，我上面的评论应该像这样更正>>>>第二个看起来很好并且验证成功通过。但是第一个（api_v1.raml）给了我“这里不允许映射值”错误。这是为什么？？谢谢，

当然，您正在尝试从 Github 验证 html 页面。您需要从这里加载原始内容：raw.githubusercontent.com/openanalytics/RPooli/master/webapp/…

在通过 HTTP 提供 RAML 规范时动态注入：github.com/openanalytics/RPooli/blob/master/webapp/src/main/…