内部REST API版本控制策略

时间:2013-09-22 08:02:56

标签: rest

我已经找到了一些通过SO和Google等版本化REST API版本的策略,但是我没有找到任何版本化内部REST apis的策略(我的意思是,我打算制作一个Web应用程序,一个Android应用程序等共享一个共同的REST api,但普通公众将无法访问API。)

看到API仅供内部使用,它需要较少的向后兼容性,基本上是一种“当前”和“边缘”或类似的方式。任何关于一个简单的策略来提示内部REST api以获得最小麻烦的提示都会很棒。

1 个答案:

答案 0 :(得分:4)

current是一种非常糟糕的区分方式。如果您的应用程序调用{​​{1}},然后升级API以便/current/users返回不同的信息,那么您的应用程序将会中断。

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