app接口设计不同版本管理

た入场券 2022-05-10 01:22 355阅读 0赞

[开发十年，就只剩下这套Java开发体系了 >>> ][Java_ _]  ![hot3.png][]

# 1    设计原因 #

APP接口的开发不同于PC WEB的开发，APP会经常的版本迭代，不同版本的APP接口可以同时使用，老版本的APP和新版APP可以同时使用，为了便于维护和管理，就有必要设计好APP接口的管理策略。

# 2    数据库及接口设计 #

数据库包含字段：app版本号、更新内容、是否强制更新。

接口传递的参数：app版本号。

# 3    升级状况 #

## 3.1    升级接口 ##

AppStore不支持强制升级，后台必须提供升级接口。

## 3.2    渠道 ##

App可能分多个渠道进行推广，比如AppStore, 越狱版本等等。 那种渠道的版本升级很可能不同。

## 3.3    强制升级     ##

版本升级中，一些版本需要强制升级到高版本。

比如， V3--->V4->>>V5--->V6。 V3可以选择性的升级到V4，V4必须升级到V5，V5可以选择性的升级到V6。

如果服务器的接口只提供最新版本的版本号和是否强制升级标识(由运营设置)，然后由客户端来比较是否要升级。 如果最新版本是V5， 那么是没有什么问题的。

但是如果最新版本已经到V6，而某个客户还停留在V3或者V4。那么如果不强制升级的话，可能就有很大的问题。

## 3.4    接口升级变化 ##

## 3.4.1    接口变化 ##

接口不可能一成不变，在不停迭代中，总会发生变化。接口的变化一般会有几种：

*  数据的变化，比如增加了旧版本不支持的数据类型
 *  参数的变化，比如新增了参数
 *  接口的废弃，不再使用该接口了

## 3.4.2    大小版本更新 ##

*  大版本更新（之前接口需要大量修改时叫做大版本更新，之前接口实在用不了了才会进行大版本更新）：大版本更新时，需要把接口所在文档重新创建（相当于重新创建一个新的APP应用），使得其不同大版本之间接口相互独立，更易维护。
 *  小版本更新（对接口的小范围修改及新增叫做小版本更新）：小版本更新时，需要在每个修改的接口中进行版本号判断，从而进行不同的分发。

# 4    实现方案 #

为了解决升级遇到的问题。一般的实现方案分为两种。

*  每个接口有各自的版本，一般为接口添加个version的参数。比如将version加到header中。
 *  整个接口系统有统一的版本，一般在URL中添加版本号，比如http://api.gateway/v1。

推荐使用第一种，第二种通过nginx路由需要多套生产环境。

[Java_ _]: https://my.oschina.net/u/3779583/blog/1862418
[hot3.png]: /images/20220510/abc0270f18244d9aa0daba5fcf6160a0.png

发表评论取消回复

表情：

评论列表（有 0 条评论，355人围观）

还没有评论，来说两句吧...

相关阅读

相关 PHP生成TOKEN（APP接口设计）

了保证移动端和服务端数据传输相对安全，需要对接口进行加密传输。因为APP端没有和PC端一样的**session机制**，所以无法判断用户是否登陆，以及无法保持用户状态...

- 日理万妓/ 2024年04月17日 05:33/ 0 赞/ 16 阅读

相关 win10安装nvm管理不同nodejs版本，切换不同版本的nodejs版本

具体可以参考这个链接教程： https://blog.csdn.net/sinat\_39323128/article/details/90766353 ![在这里插入图

梦里梦外;/ 2022年11月10日 14:55/ 0 赞/ 198 阅读

相关 App架构设计经验谈:接口的设计

App与服务器的通信接口如何设计得好，需要考虑的地方挺多的，在此根据我的一些经验做一些总结分享，旨在抛砖引玉。安全机制的设计现在，大部分App的接口都采用RESTf

逃离我推掉我的手/ 2022年07月30日 20:57/ 0 赞/ 146 阅读

相关 APP接口设计安全问题

我的问题是，如果不做安全相关处理的话，一些可能改变数据库的操作可能会遭遇垃圾数据提交什么的，毕竟要找到这些信息只要找个http包就可以了系统无用户登录新手问题（从来没做

野性酷女/ 2022年07月21日 02:47/ 0 赞/ 128 阅读

相关 app开放接口签名设计与实现

只要接口暴露在外网，就避免不了安全问题。如果让接口裸奔，其他人只要知道接口地址和参数就可以调用，那简直就是灾难。试想有一个发送注册验证码的接口，如果仅仅知道接口地址和参数（手机

末蓝、/ 2022年06月07日 12:48/ 0 赞/ 203 阅读

相关 APP架构设计经验谈:接口的设计

转载:http://keeganlee.me/post/architecture/20160107 App与服务器的通信接口如何设计得好，需要考虑的地方挺多的，在此根据我的

布满荆棘的人生/ 2022年06月04日 07:19/ 0 赞/ 179 阅读

相关接口API版本管理

1. 引入jar依赖 <dependency> <groupId>com.slowlybirld</groupId> <artifac

「爱情、让人受尽委屈。」/ 2022年05月14日 10:51/ 0 赞/ 244 阅读

相关 app接口设计不同版本管理

[开发十年，就只剩下这套Java开发体系了 >>> ][Java_ _] ![hot3.png][] 1 设计原因 APP接口的开发不同于PC WEB的

た入场券/ 2022年05月10日 01:22/ 0 赞/ 356 阅读

相关 App架构设计经验谈:接口的设计

App与服务器的通信接口如何设计得好，需要考虑的地方挺多的，在此根据我的一些经验做一些总结分享，旨在抛砖引玉。 \[b\]安全机制的设计\[/b\] 现在，

素颜马尾好姑娘i/ 2022年04月12日 12:18/ 0 赞/ 209 阅读

相关 h5 app版本管理

基于mui框架做一个简单的版本管理；原理：在通用js中设置一个版本号，然后在个人中心界面设置一个版本管理li ![20190315201126543.png][

深藏阁楼爱情的钟/ 2022年03月07日 00:30/ 0 赞/ 268 阅读