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

Question

如题，我有两个 RAML 文件，一个与 v1 API 版本相关，第二个属于 v2 API 版本。我的问题是，如果我将我的根 URL 与 API 文档一起传递给某人，我不确定当有人进入 API v1 页面时他将能够获取一些信息（“这是旧的 api 版本，请转到 API v2: 链接") 并将链接重定向到 API v2？

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

感谢您的任何回复

Answer 1

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

Answer 2

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

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