是否可以在 RAML 文件中添加重定向链接，例如到另一个 API 版本？

Question

如主题所示，我有两个 RAML 文件，一个与 v1 API 版本相关，第二个属于 v2 API 版本。我的问题是，如果我将带有 API 文档的根 url 传递给某人，我不确定当某人进入 API v1 页面时他们将能够看到一些信息（“这是旧的 API 版本，请转到 API v2：链接”）并将链接重定向到 API v2？

有什么方法可以将此重定向链接放入 v1 RAML 文件中吗？

Answer 1

documentation

部分支持Markdown，因此您可以轻松地在那里插入链接。

Answer 2

是的，如果它不起作用，您可以添加直接 URL，那么您也可以尝试以下语法

response:
  200:
    example:
      {
        "redirecturl":"URL Location"
      }