如何用RAML在API端点文档中显示绝对url

Question

我使用RAML来记录我的REST API。在RAML文档中，我指定了根级别的基URL

baseUri: http://api.example.org/api/{version}
version: v1

然后在文档的API端点部分，我指定它们相对于这个基的URL，例如

/foo/bar:
    get:
      description: blah blah blah

当我运行raml2html从RAML文档生成HTML页面时，相对URL /foo/bar显示在API端点的文档中，但我更愿意显示绝对URL http://api.example.org/api/v1/foo/bar，这是可能的吗?

Answer 1

raml2html允许为整个文档包装器、每个资源和每个项使用自定义模板。

在您的情况下，您想要自定义资源模板，然后与-r custom-resource.handlebars参数一起使用。