rest - 如何使用 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参数一起使用。