API版本控制的最佳实践？

Question

API版本控制的最佳实践？

对于Web服务RESTAPI版本有任何已知的方法或最佳实践吗？

我注意到AWS通过端点的URL进行版本控制..这是唯一的办法，还是有其他方法来实现同样的目标？如果有多种方法，那么每一种方法的优点是什么？

Answer 1

我们发现将版本放在URL中既实用又有用。它让你很容易一眼就知道你在用什么。我们使用别名/foo到/foo/(最新版本)，以便于使用、更短/更干净的URL等等，正如公认的答案所示。永远保持向后兼容性往往成本高昂和/或非常困难。我们更喜欢提前通知反对意见，重定向，就像这里建议的那样，Docs和其他机制。