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

原创
2017/11/21 13:27
阅读数 2.7W

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

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

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

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://apijson.org/

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

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

 

TommyLemon:

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

URL: http://apijson.cn: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

展开阅读全文
加载中
点击加入讨论🔥(17) 发布并加入讨论🔥
打赏
17 评论
57 收藏
3
分享
返回顶部
顶部