Web API 版本控制的几种方式
2014-03-05 20:28
106 查看
http://www.troyhunt.com/2014/02/your-api-versioning-is-wrong-which-is.html
这篇文章写得很好,介绍了三种实现web api版本化的三种方式。我从评论里又收集到两种方式,所以一共是5种:
方式一:利用URL
这篇文章写得很好,介绍了三种实现web api版本化的三种方式。我从评论里又收集到两种方式,所以一共是5种:
方式一:利用URL
HTTP GET: https://haveibeenpwned.com/api/v2/breachedaccount/foo[/code]
方式二:利用用户自定义的request headerHTTP GET: https://haveibeenpwned.com/api/breachedaccount/foo api-version: 2
方式三:利用content typeHTTP GET: https://haveibeenpwned.com/api/breachedaccount/foo Accept: application/vnd.haveibeenpwned.v2+json
方式四:利用content typeHTTP GET: https://haveibeenpwned.com/api/breachedaccount/foo Accept: application/vnd.haveibeenpwned+json; version=2.0
这个方式和方式三的小不同的地方是,把版本号分离出来了。
方式五:利用URL里的parameterHTTP GET: https://haveibeenpwned.com/api/breachedaccount/foo?v=2[/code]
作者说他最喜欢第三种方式,因为
URL不用改变
客户端应该通过accept header来表明自己想接收的是什么样的数据。
但作者很蛋疼地在他的网站上把前面三种方式都实现了,而且都支持。 https://haveibeenpwned.com/API/v2
我个人最喜欢的是第二种方式,因为这个用spring mvc实现最容易,也最简洁。
因为只要在Controler上用@RequestMapping标明版本即可。不用再去各种匹配,各种识别。
如果是自己写一个Annotation来识别的话,也要花些功夫,而且怎么无缝地转发到原有的Spring mvc的配置也是个问题。@Controller @RequestMapping(headers="apt-version=2") public class TestControllerV2 { }
另外这个网站列举了很多国外的有名网站是如何实现web api版本控制的。
http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/
相关文章推荐
- Web API 版本控制的几种方式
- Web API 版本控制的几种方式
- Web API 版本控制的几种方式
- ****Web API 版本控制的几种方式
- ASP.NET Web API中实现版本的几种方式
- JS控制的几种页面跳转方式和传值
- 总结iOS App开发中控制屏幕旋转的几种方式
- 2016/2/24 1,css有几种引入方式 2,div除了可以声明id来控制,还可以声明什么控制? 3,如何让2个div,并排显示。4,清除浮动 clear:left / right / both
- Spring 控制反转的几种方式
- 线程同步控制的几种方式
- 使用SubVersion+TortoiseSVN多仓库方式进行版本控制
- ASP.Net Core WebApi几种版本控制对比
- 登录验证全局控制的几种方式(session)
- MAC下安装多版本JDK和切换几种方式
- Android 使用版本控制工具时添加忽略文件方式
- CSS控制页面的几种方式以及各种方式的优先级
- 使用SubVersion+TortoiseSVN多仓库方式进行版本控制
- struts2业务控制类(Action)获取页面请求参数的几种方式
- 【ARM】控制寄存器的几种方式