接口描述：

  • 客户端最新版本查询接口 （无需鉴权）

接口版本：

版本号 制定人 制定日期 修订日期
1.0.0 马腾飞 2019-10-14 2019-10-14

请求URL:

  • 商户接口URL/api/clientVersion

请求方式：

  • GET
  • POST

请求参数:

参数名 是否必须 类型 说明
clientType 是 String 客户端类型：【FACE_CLIENT】: 刷脸设备 , 【MCH_APP】: 商家手机客户端, 【PC_PLUGIN】: 商家PC收银插件
currentVersionSN 是 String 当前版本序列号

返回参数说明:

参数名 类型 说明
code int 0
msg String success
data json 最新版本的更新日志及下载地址

返回数据说明:

参数名 类型 说明
vid Long 当前版本ID
versionName String 版本名称
versionSN String 版本序列号
versionDesc String 版本描述信息
forceUpdate int 是否需要强制更新 1-是, 0-否
downloadUrl String 下载地址
fileSize String 文件大小，单位：M
clientType String 客户端类型：【FACE_CLIENT】: 刷脸设备 , 【MCH_APP】: 商家手机客户端, 【PC_PLUGIN】: 商家PC收银插件
createTime String 创建时间
updateTime String 更新时间

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "vid": 200032,
    "versionName": "mch_upd_1",
    "versionSN": "V1.0.3.build20191014",
    "versionDesc": "1.更新了商户APP首页, 2.修复了部分已知bug",
    "forceUpdate": 0,
    "downloadUrl": "http://baidu.com/down/31148f6e8a884bc8a551fe6e2f05eb4a.apk",
    "fileSize": "12.26",
    "clientType": "FACE_CLIENT",
    "createTime": "2019-10-14 15:39:11",
    "updateTime": "2019-10-14 15:39:14"
  }
}

备注:

  1. 仅code = 0 时返回最新版本信息， 否则data为null ；
  2. 如当前版本为最新版本且没有更高版本时，返回data为空对象, 示例： 
    {
"code": 0,
"msg": "success",
"data": {}
}
  3. 若查询当前版本失败（数据库无该版本信息）， 则返回数据为最新版本信息并要求强制更新。

-

文档更新时间: 2021-10-25 17:35   作者：刘正阳