rest - 内部 REST API 版本控制策略

Question

我找到了一些通过 SO 和 Google 等对 REST API 进行版本控制的策略，但我还没有找到任何对内部 REST API 进行版本控制的策略（我的意思是，我打算制作一个 Web 应用程序、一个 Android 应用程序等共享一个常见的 REST api，但公众将无法访问该 API）。

鉴于 API 仅供内部使用，它需要较少的向后兼容性，并且基本上是一种“当前”和“边缘”或类似的方式。任何关于对内部 REST api 进行版本控制以减少麻烦的简单策略的任何提示都会很棒。

Answer 1

current是一种非常糟糕的区分方式。如果您有一个应用程序执行对 的调用/current/users，然后您升级您的 API 以/current/users返回不同的信息，您的应用程序将中断。

坚持版本控制。简单/v1/users明了，简洁明了，当您添加时，/v2/users使用旧 API 端点的应用程序将继续工作，您可以根据需要更新它们。