Web API 版本控制的几种方式
来源:互联网 发布:暗黑训练营升级数据 编辑:程序博客网 时间:2024/05/20 21:22
http://www.troyhunt.com/2014/02/your-api-versioning-is-wrong-which-is.html
这篇文章写得很好,介绍了三种实现web api版本化的三种方式。我从评论里又收集到两种方式,所以一共是5种:
方式一:利用URL
HTTP GET:https://haveibeenpwned.com/api/v2/breachedaccount/foo
方式二:利用用户自定义的request header
HTTP GET:https://haveibeenpwned.com/api/breachedaccount/fooapi-version: 2
方式三:利用content type
HTTP GET:https://haveibeenpwned.com/api/breachedaccount/fooAccept: application/vnd.haveibeenpwned.v2+json
方式四:利用content type
HTTP GET:https://haveibeenpwned.com/api/breachedaccount/fooAccept: application/vnd.haveibeenpwned+json; version=2.0
这个方式和方式三的小不同的地方是,把版本号分离出来了。
方式五:利用URL里的parameter
HTTP GET:https://haveibeenpwned.com/api/breachedaccount/foo?v=2
作者说他最喜欢第三种方式,因为
- 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/
1 1
- Web API 版本控制的几种方式
- Web API 版本控制的几种方式
- Web API 版本控制的几种方式
- 关于Web API 版本控制的一些想法
- Spring 控制反转的几种方式
- 实现权限控制的几种方式
- 线程同步控制的几种方式
- 多线程的几种控制方式
- 【ARM】控制寄存器的几种方式
- HOOK API 的几种方式
- 怎么做 Web API 版本控制?
- 几种Web Service的调用方式
- web中缓存的几种方式
- web中缓存的几种方式
- web中缓存的几种方式
- web中缓存的几种方式
- web service的几种实现方式
- Web Service的几种调用方式
- 欧拉计划 第9题
- Fuck TextField自定义子类(self.delegate = self异常退出)
- 十六进制数转八进制 大数转化
- 小议layerX/Y offsetX/Y 的区别 In Chrome
- SpriteKit学习笔记(七)SKEmitterNode(粒子系统)、SKCropNode和SKEffectNode
- Web API 版本控制的几种方式
- JAVA和C# 3DES加密解密
- PAT 1052. Linked List Sorting
- Android 开发环境配置图文教程(jdk+eclipse+android sdk)
- 台阶
- LeetCode(63)UniquePath2
- 正则表达式模板
- 输出二叉树中第m层的第k个节点值
- KanKanStyle转载:Android开发高级动画接口 Interpolator