Url应用获取版本详细信息

接口描述：基于客户端的版本号，获取对应的版本详细信息

📮请求信息

请求地址

POST https://api.upgrade.toolsetlink.com/v1/url/version

请求头 (Headers)

参数名	必选	类型	示例值	说明
X-Timestamp	是	string	2025-02-17T10:34:55+08:00	请求时间 RFC3339格式
X-Nonce	是	string	fc812cc0b9b51e8c	唯一随机字符串(至少16位)
X-AccessKey	是	string	mui2W50H1j-OC4xD6PgQag	密钥 AccessKey
X-Signature	是	string	3603437250c2df51fc46426ac79d8995	请求签名 签名规则
Content-Type	是	string	application/json

🔐 防重放攻击机制

1. 服务端验证时间戳与服务器时间差值不超过±5分钟
2. 服务端会校验Nonce值是否已存在（防止重复请求）

请求体 (Body)

{
    "urlKey": "LOYlLXNy7wV3ySuh0XgtSg",
    "versionCode": 1
}

请求体参数说明

参数名	必选	类型	示例值	说明
urlKey	string	LOYlLXNy7wV3ySuh0XgtSg	Url应用唯一标识
versionCode	是	int	1	客户端版本号

📮响应信息

成功响应体

{
  "code": 200,
  "msg": "获取到新版本",
  "data": {
    "urlKey": "LOYlLXNy7wV3ySuh0XgtSg",
    "versionName": "v2",
    "versionCode": 2,
    "description": "描述内容"
  }
}

响应体参数说明

参数名	类型	示例值	说明
urlKey	string	LOYlLXNy7wV3ySuh0XgtSg	Url应用唯一标识
versionName	string	v1	版本名
versionCode	int	1	版本号
description	string	描述内容	描述内容

典型错误响应体

{
  "code": 404001,
  "msg": "未获取到可使用版本",
  "docs": "未查询到对应的应用版本，请确认在系统中是否已经正确创建。 请参考文档: https://upgrade.toolsetlink.com/upgrade/recommend/apk/app-version.html",
  "data": null
}

📊状态码

http 状态码	code	场景描述	解决方案
200	200	请求成功
400	400001	非法请求
400	400002	参数缺失
400	400003	参数非法
400	400004	报头非法
400	400005	报体非法
401	401001	鉴权失败
401	401002	签名验证失败
404	404001	资源不存在
404	404002	查询记录不存在
404	404003	处理方式不存在
404	404004	请求不存在
500	500001	服务器内部错误	请联系我们 联系我们
500	500002	服务器内部校验数据失败	请联系我们 联系我们