文件应用获取升级策略

接口描述：基于客户端的版本号，获取对应的升级策略,兼容tauri 官方提供的文件升级接口返回信息。tauri动态更新

📮请求信息

请求地址

GET http://api.upgrade.toolsetlink.com/v1/tauri/upgrade?tauriKey=a0jtz0HUwL66r7gCGvbMKQ&versionCode=1&appointVersionCode=0&devModelKey=&devKey=&target=linux&arch=x86_64

请求头 (Headers)

参数名	必选	类型	示例值	说明
X-AccessKey	是	string	mui2W50H1j-OC4xD6PgQag	密钥 AccessKey

请求参数说明

参数名	必选	类型	示例值	说明
tauriKey	是	string	a0jtz0HUwL66r7gCGvbMKQ	Tauri应用唯一标识
versionCode	是	int	1	系统中录入的版本号
appointVersionCode	否	int	0	期望升级版本号，不传或传0为请求最新版本
devModelKey	否	string	stv1	设备机型唯一标识
devKey	否	string	LOYlLXNy7w	设备唯一标识(可以使用 mac 作为唯一标识)
target	是	string	linux	操作系统:linux、darwin、windows
arch	是	string	x86_64	机器架构:x86_64、i686、aarch64、armv7

📮响应信息

成功响应体

{
  "version": "v2",
  "versionCode": 2,
  "notes": "",
  "pub_date": "2025-05-26T20:40:30+08:00",
  "url": "https://upgradelink.oss-cn-beijing.aliyuncs.com/upgrade/2025-05-26/other/01970c9b-be88-70db-b4bd-92303c8d1fef.json?x-oss-credential=LTAI5tA5mxKLLfa6FxPoTkqE%2F20250527%2Fcn-beijing%2Foss%2Faliyun_v4_request&x-oss-date=20250527T135625Z&x-oss-expires=600&x-oss-signature=fc961fcd21ecd763946ec123be1ef0504713f2189036fe57b687ed2917b570e8&x-oss-signature-version=OSS4-HMAC-SHA256",
  "signature": ""
}

响应体参数说明

返回内容与官方 tauri 动态更新接口返回内容一致。 tauri动态更新

参数名	类型	示例值	说明
version	string
versionCode	int	1	版本号
notes	string		更新说明。
pub_date	string		版本日期
url	string		版本文件 URL
signature	string		生成的 .sig 文件的内容

典型错误响应体

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

📊状态码

http 状态码	code	场景描述	解决方案
200		请求成功，获取到版本升级策略
204		已经是最新版本
400	400001	非法请求
400	400002	参数缺失
400	400003	参数非法
400	400004	报头非法
400	400005	报体非法
401	401001	鉴权失败
401	401002	签名验证失败
404	404001	资源不存在
404	404002	查询记录不存在
404	404003	处理方式不存在
404	404004	请求不存在
429	429001	应用任务策略请求流控限制	当前升级任务配置的请求流控策略，已经达到限制，请稍后再试。
500	500001	服务器内部错误	请联系我们 联系我们
500	500002	服务器内部校验数据失败	请联系我们 联系我们