我们有一个项目，现在几乎完成，并有数百个现有的WEB API服务。我们已经在wiki上记录了所有的设计和示例URL。现在我们已经接近尾声，我的任务是找到一个更真实地用于文档WEB API服务的产品，如API Blueprint或Swagger。我将一些API服务从我们的wiki迁移到API Blueprint和Apiary。
但是这个编辑器有点笨拙，现在我偶然发现了RAML，它更喜
浏览 1提问于2016-07-13得票数 1
我只是好奇地想知道在从RAML生成的文档中排除/包括端点的可能性是什么。例如，给定baseUri: https://api.mybanks.com/v1version: v1
protocols: [HTTP,
浏览 6提问于2020-02-27得票数 0
我们还为API编写了公共文档。它目前是用Markdown编写的，以方便和方便地导出。我们在版本控制中维护文档，使其与模块本身中端点的更改保持最新。我们目前正在Drupal 7，如果它是相关的。编辑：我们使用服务模块来管理<em
浏览 0提问于2017-04-11得票数 2
2回答
我需要为请求创建一个RAML数据类型，用户可以在其中输入名字和姓氏或业务名称。如果用户输入的是名称，那么他也应该提供姓氏，而不是业务名称。#%RAML 1.0 DataType account_number: required: true#%RAML 1.0 DataType account_number: required: t
浏览 2提问于2020-11-17得票数 0
1回答
我是RAML的新手。我们已经用jax-rs编写了REST服务。现在，我们希望集成RAML来生成这些API的文档。还从下载了存储库。给出了jax-rs到RAML 的实例我想知道如何从eclipse运行这些示例，以及如何使用已编写的REST与RAML jax-rs 一起生成。更新：
我将示例导入到现有的<
浏览 0提问于2015-10-15得票数 1
回答已采纳
使用java中的mule使用RAML进行api集成是否必要？
浏览 3提问于2014-09-24得票数 0
回答已采纳
我正在使用 Go库来实现REST API服务，并且我决定尝试使用来提供一些与我的API相关的模式文件。我注意到它在幕后使用了Go方便的内置包来提供静态文件。它几乎可以完美地工作，除了一点: RAML文件使用内容类型text/plain提供服务。但是，我注意到我使用application/json提供的JSON schema文件，所以很明显静态文件服务存在某种类型的MIME类型关联
浏览 44提问于2016-08-13得票数 1
我正在为我的Mule应用程序定义一个RAML规范。即使这在RAML中定义如下： /resource/*:我想知道以下几点：
如何定义RAML规范，以便具有/client/{clientId}//*的所有请求都将被
浏览 7提问于2019-08-26得票数 0
我有一个只有一个端点的RAML。在骡子应用程序中导入此RAML。现在我有了一个get端点的api路由器工具包。如果我已经更新了我的RAML并添加了新的POST端点，那么我如何在现有的mule应用程序中导入最新的RAML。
浏览 8提问于2022-06-26得票数 1
回答已采纳
1回答
我没有找到任何合适的例子，在主RAML文件中，example被正确地用作DataType。大多数情况下，它被用作.json/.xml文件。有没有合适的细节或参考资料我可以找到。使用AnyPoint平台设计中心构建RAML。
浏览 4提问于2021-09-24得票数 0
我使用的是中的odata示例。请求：?"results": [ "__metadata": { {
"__metadata&qu
浏览 5提问于2018-02-09得票数 0
1回答
自动JAX-RX到RAML
、、、、
我使用resteasy编写了Java项目的web服务。对于文档过程，我希望使用RAML捕获这些web服务。因此，我的问题是-是否有一种方式，所有的类是为web服务或包下，一个raml文件是在项目打包期间生成的。假设在构建过程中使用maven。
浏览 3提问于2015-10-13得票数 0
回答已采纳
1回答
我是一个新的项目，他们想要使用RAML来定义API。我得到了用于Eclipse的RAML-JAX-RS p0lugin。这样，我就能够从现有的REST服务中生成一个RAML文件。只生成REST服务器接口。
我尝试寻找一种方法来生成客户机类和文档文件。(我假设它能做到这一点，就像HTML文件一样。)我见过一些用来生成客户端代码的maven插件代码，但我看不出它是如何工作的。有人知道如何生成这些代码吗？无论是从Eclip
浏览 10提问于2016-08-16得票数 0
我使用来记录REST。在RAML文档中，我在根级别指定了基本URL。baseUri: http://api.example.org/api/{version}然后在文档的API端点部分中，我指定了它们相对于这个基的URL。/foo/bar: description: blah blah blah
当我运行raml2html从RAML生成一
浏览 4提问于2015-05-14得票数 1
回答已采纳
我正在尝试导入我的RAML文件，并使用APIKit路由器在现有项目中生成所需的流。我正在导入的RAML是直接从API Manager生成的zip中导入的，它说它是有效的，而且在任意点的Studio中打开它时也没有问题(它是有效的)。现在，针对这个问题--当我将APIKit路由器组件引入项目并添加配置时，我选择RAML文件作为常规，但是当我单击add映射时，会得到以下错误：
“文件api.raml不存在。请指定现有的RAML文件或将<e
浏览 6提问于2016-03-30得票数 0
回答已采纳
1回答
系统API设计方法
、、、、
我想设计系统API，这将与REST服务连接使用RAML的医疗保健领域。后端Rest服务将有GET/POST请求。GET/POST请求通常服务于getCollection/getById/getByName。
我如何开始设计RAML？哪种方法是最好的、最标准的？任何人都可以在下面的项目中帮助我。用于命名Process/System/Experience API的命名约定。URI
浏览 0提问于2018-03-29得票数 0
8回答
使用REST，我们可以使用Swagger、RAML或其他技术来记录我们的API，并生成一个HTML文档，我们的使用者可以阅读这些文档，而无需与服务器进行任何交互。
浏览 12提问于2016-09-15得票数 74
回答已采纳
我在mulesoft api设计器中使用的是RAML 1.0。#%RAML 1.0baseUri: https://mocksvc.mulesoft.com/
浏览 3提问于2016-06-29得票数 1
我已经生成了一个apikit路由器，它将路由到一个raml文件并从它生成一个xml流。org.mule.module.apikit.exception.ApikitRuntimeException:无效API描述符--发现错误:1 Raml解析器未命名异常: null我的RAML定义只是一个模拟测试：title: mocktest descriptio
浏览 2提问于2018-01-09得票数 0
回答已采纳
如何调用在基于APIKit的消息流中返回JSON的rest服务。我希望为Rest服务准备请求，并希望在消息流中提取JSON消息。谢谢
浏览 2提问于2015-07-13得票数 0
云服务器
ICP备案
云直播
即时通信 IM
实时音视频
腾讯云开发者
