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

Question

在主题中，我有两个 RAMLs 文件，一个与 v1 API 版本相关，第二个属于 v2 API 版本。我的问题是，如果我将我的根 url 和 API 文档传递给某人，我无法确定当某人进入 API v1 页面时他将能够看到一些信息 ("This is old api version please go to API v2: link") 并将 link 重定向到 API v2?

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

感谢任何回复

Answer 1

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

Answer 2

是的 你可以添加 Direct URL 如果它不起作用那么你也可以尝试下面的语法

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