后端自动化版本管理，再也不用改URL了！

每次升级接口版本时，后端、前端、客户端都是痛苦的：

后端：要兼容旧版客户端，以前的接口不能动啊，又得写新接口、新文档了，唉！

前端：还好，就是版本号到处都是，改起来比较烦。

Android：快点啊产品催需求呢，服务器别停太久。对了你知道编译一次要多久么？泪奔。。。

前端：对对，别停太久。还有文档别再写错了啊，上次你复制粘贴的 v3 害我接口调了半天，原来是 v4 。。。

iOS：我也被坑了。。。

后端：呃，我尽快，写文档会注意的哈。

后端：另外旧域名 http://api.aaa.com/v4 也会一直开着，保证不会像上次那样让3.0客户端请求挂的。

后端：@前端 对了，你们用一个全局的 BASE_URL 存起来，以后改一个地方就好了。

Android：我们就是这么干的嘿嘿！

iOS：我们也是，还是我封装的。

iOS：但问题是往往多个接口版本并存，还是要写好几个BASE_URL，我们这是从BASE_URL_V2到BASE_URL_V4。

Android：唉，这个就没办法了。

前端：我们现在也是这么做的，但之前的那家伙没封装啊，写得到处都是。。。

后端：周哥，升级接口版本好烦啊，你有什么好的办法吗？

周哥：具体说下你的问题。

后端：每次都要写新的接口和文档，服务器也要重启，前端和客户端总是抱怨改域名和文档错误。

项目很赶，文档是复制粘贴的，总是会落下某些地方没改。

但是不复制粘贴吧，你看看这格式，重新写实在是太麻烦了！

周哥：哈哈，以前我们也总是碰到这种问题，现在解决了。试试这个

周哥：https://github.com/TommyLemon/APIJSON

后端：哇，居然还有这么厉害的后端框架啊！我只用过SSH。

周哥：我也是上个月才知道的，朋友推荐的，我试了一周，非常好用，也没啥大的问题，就整到项目中了。

周哥：SSH太重了，老项目中APIJSON主要用来实现新接口，新项目就只用APIJSON了。

后端：可以的。不过它怎么解决版本问题呢？文档里没说啊。

周哥：写在最下面了。 http://39.108.143.172/

后端：可在最外层传版本version来指定使用的版本，不传或 version <= 0 则使用最新版。 ？？

周哥：描述确实比较简单，我就问了下作者，他是这么说的：

TommyLemon:

可以在请求时传入一个version来指定使用的接口版本号，例如查询用户隐私信息：

URL: http://39.108.143.172:8080/gets

表单:

{
    "Privacy": {
        "id": 82001,
        "_password": "123456"
    },
    "tag": "Privacy",
    "version": 1
}

而且只需要登录时传一个全局默认version，之后所有需要登录的接口(一般占绝大部分)就都默认用这个了。

{
    "type": 0,
    "phone": "13000082001",
    "password": "123456",
    "version": 1
}

所以查询用户隐私信息就可以省略version了：

{
    "Privacy": {
        "id": 82001,
        "_password": "123456"
    },
    "tag": "Privacy"
}

因为上面传的version和全局默认version一样，所以服务器返回的结果都一样：

{
    "Privacy": {
        "id": 82001,
        "certified": 1,
        "phone": 13000082001,
        "balance": 8067
    },
    "code": 200,
    "msg": "success"
}

当然如果某个请求需要用到和全局默认version不一样的接口，也可以指定当前的version：

{
    "Privacy": {
        "id": 82001,
        "_password": "123456"
    },
    "tag": "Privacy",
    "version": 2
}

由于第2版接口改了校验配置，所以返回结果就不一样了：

{
    "Privacy": {
        "id": 82001,
        "_password": "123456"
    },
    "code": 406,
    "msg": "Privacy不允许传 _password 等[_password, _payPassword]内的任何字段！"
}

注：这个接口需要登录权限，请先点击右上角登录后再请求。

APIJSON在线测试

周哥：我照着这个来，在测试网页一个个试了，确实是这样的。

后端：但还有个问题，项目中可能多个版本并存，它是不是也要同时维护多个版本啊？

周哥：哈哈，以前只有两种做法：

1.前端根据的需求调对应版本的api，后端只新增对应新需求的api。

2.前端只用一个版本，后端对新版不需要改的api v2也提供一个对应新版的api v3，然后和v2一样处理，可以提取v2的代码为一个公共的函数。

或者就干脆重定向到v2，这个操作简单些，但要损失一些性能。

周哥：用APIJSON就只需要把原来旧版的api改下版本号version为一个统一的最新版，请求中传的version如果不存在，则会自动转到比它高的最接近版本。

后端：也就是我把v1,v2都改成v3，然后前端传v1或v2过来，它就转到v3了？如果不改的话还是转到v2？

周哥：对的。如果不传version或version<=0，就会强制用最新版。这个在修复某些api漏洞时很有用，把前端请求中的version去掉或者改成0，就可以了。

后端：我觉得可以直接把api的version改成最新版，这样更简单。

周哥：确实，小伙子你很聪明啊。

后端：哈哈，谢谢周哥，我去试试。

后端：作者很牛啊

周哥：哈哈，我之前也好奇什么人能写出这样的框架。

周哥：接口都不用写了，都是框架自动实现的，话说现在终于没人再催接口了哈哈！

后端：真的很好用啊，以后就让前端客户端都在登录时传一个version就搞定了。

后端：不过项目中还有些不需要登录就能访问的接口，例如注册、找回密码等，这些就只能每次都传一个version了。

周哥：是的，不过绝大部分接口都是要登录后才能访问的啊。

后端：也是啊。

后端：对了，普通的查询请求好像没version的示例啊。

周哥：因为不需要哈哈，作者说GET，HEAD请求都是开放请求，没有版本限制。我试过了确实是这样。

后端：也就是不用传version？

周哥：是的，而且请求非常灵活，可以定制请求的内容、JSON结构，一大堆查询请求的接口都不用自己写了。

后端：这样啊，太棒了，我去Star一下。

后端：@前端 @Android @iOS 新版接口写好了。

后端：大家把新版请求的主域名改成 http://api.aaa.com，以后登录时再传一个version就好了。

{
  "version":5
}

前端：这么快？

iOS：这么快？

Android：这么快？

后端：用了新框架嘿嘿！

Android：不用换版本号v5了？

iOS：以后会要加上吗?

后端：不用了，以后也不用 v6,v7 了，域名不会再改了。

iOS：那不需要登录的接口呢？

后端：不用管，这几个接口很稳定，暂时不会动的。

Android：可以的

iOS：赞

前端：厉害，怎么做到的啊？

后端：大家看下这个，我们后端以后的接口都用新框架写。

后端：https://github.com/TommyLemon/APIJSON

iOS：支持

前端：+1

Android：好棒，我也玩一玩后端嘿嘿！

APIJSON - 后端超光速开发框架

Github源码及文档（右上角点Star支持下吧^_^）

https://github.com/TommyLemon/APIJSON

下载客户端（测试服务器地址：http://apijson.cn:8080）

APIJSONClientApp.apk