作者：chszs，转载需注明。博客主页：http://blog.csdn.net/chszs
在设计和构建API时，API的版本控制是非常重要的。
必须确保新API对于现有的API不会造成破坏。
首先，也是最重要的，可以把版本号放入API的URL中。这样可以把主要版本更新放入API。比如，我们在调用CHUser Center API时，可以在URL中使用/api-v1或/api-v2来指出所使用的API版本。这是很常见的做法。
在API版本控制中，还有一点也很重要。希望API能支持次要版本的更新。次要版本更新所造成的变化仍然会影响接口，因此有可能会影响当前API的使用者，但它们与主版本的URL和API的基本功能都在变化不同，URL和API基本功能仍然是相同的。比如在CHUser Center API，次要版本的修改是通过客户在API调用时发起请求的HTTP头部做指定的。
作者：chszs，转载需注明。博客主页：http://blog.csdn.net/chszs
头部的版本元素看起来是这样的：
Element-Version: 1我们决定把JSON字段中的firstN改成firstName。很显然，这只是一个小改动，所以它属于API次要版本更新的范畴，无须做主版本的修改和不同的URL签名。因此，我们会创建另一个GET /people接口，要调用它还需要在HTTP头部加上
Element-Version: 2
然后就会返回以下JSON数据：
原文地址：http://blog.csdn.net/chszs/article/details/42779095
