# 检查更新（免登录）
# 目录
# 接口说明
本接口用于客户端在未登录状态下检查是否存在新版本，并返回是否需要升级、是否强制升级以及最新版本的下载信息。
# 接口介绍
本接口与检查更新的业务逻辑、请求参数、返回结构完全一致，唯一区别是不需要登录态，适用于以下场景：
- 客户端启动页 / 登录前的版本检查（此时用户尚未登录，拿不到 token）；
- 强制升级场景：客户端版本过低时，需要在进入登录流程之前就拦截并引导升级；
- 游戏厂商在自有启动器中直接查询版本，不集成平台的登录体系。
与检查更新的区别：
检查更新（本接口） 检查更新（需登录） 接口路径 /open/public/check/open/check是否需要登录态 否 是 Authorization请求头不需要 需要 请求 / 响应结构 完全相同 完全相同 若调用时已持有用户 token，两个接口可任选；若在登录前调用，必须使用本接口。
# 接口配置入口
- 登录氦闪 开发者平台 (opens new window)
- "接口管理" 》 "平台接口" 》 "模块API" 》 "版本管理模块"
- 选择 "版本中心服务检查更新(免登录)"
- 右上角选择开启
提示：此接口数据持久化使用 MongoDB 数据库，请确保已配置相关数据源。 本接口无需登录态，请求头不需要
Authorization。 多租户数据源按请求头APPID自动切换，请求体无需传appid。
# 接口调用
# 检查更新（免登录）
- 接口地址：
https://lb/business-service/hiasoon-versionmanagercenter/open/public/check - 返回格式：json
- 请求方式：POST
- 请求示例：
{
"platform": "ANDROID",
"versionNumber": "2.0.0",
"versionCode": 20000
}
# 请求头：
| 参数名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| APPID | string | 开发者平台分配的应用APPID | 是 |
| _t | number | 请求时间戳（毫秒级） | 是 |
| _s | string | 签名信息，用于接口安全验证 | 是 |
| _n | string | 随机数 | 是 |
注意：本接口为免登录接口，不需要
Authorization请求头。
# 请求体（json）：
| 参数名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| platform | string | 平台类型：WEB/ANDROID/IOS/WINDOWS/MACOS/LINUX/SDK/PLUGIN | 是 |
| versionNumber | string | 客户端当前版本号，格式 x.x.x 或 v.x.x.x | 否 ※ |
| versionCode | number | 客户端当前数字版本号，如 20000（推荐传递）
| 否 ※ |
※ 说明：
versionNumber与versionCode至少填写一个，建议优先传递versionCode以保证版本比较准确。版本比较规则：服务端仅比较
ONLINE（正式发布）状态的版本，优先使用数字版本号versionCode；缺失时按下列规则解析versionNumber：1.5.0 → 01 05 00 → 10500 1.10.0 → 01 10 00 → 11000 v2.1.5 → 02 01 05 → 20105
# 响应头：
| 参数名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| connectionid | string | 本次请求的唯一标识 | 是 |
| _t | number | 响应时间戳（毫秒级） | 是 |
| _s | string | 响应签名信息，用于防篡改校验 | 是 |
| _n | string | 随机数（与本次请求的值一致） | 是 |
# 返回参数（json）
返回结构与检查更新完全一致：
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | number | 返回状态码，200 表示成功，其他表示失败 |
| message | string | 返回信息描述 |
| data | object | 检查更新结果 |
| data.hasUpdate | boolean | 是否存在新版本 |
| data.forceUpgrade | boolean | 是否强制升级（升级类型为 FORCE 或低于最低支持版本） |
| data.latestVersion | object | 最新版本信息，无已发布版本时为 null |
| info | object | 附加信息，一般为 null |
data.latestVersion 字段说明详见检查更新。
返回参数示例（存在新版本且强制升级）：
{
"code": 200,
"message": "操作成功",
"data": {
"hasUpdate": true,
"forceUpgrade": true,
"latestVersion": {
"id": "6650f2b8c1a2b3d4e5f60718",
"platform": "ANDROID",
"versionNumber": "2.1.0",
"versionCode": 20100,
"status": "ONLINE",
"upgradeType": "FORCE",
"downloadUrl": "https://cdn.hiasoon.com/app/hiasoon-2.1.0.apk",
"packageSize": 104857600,
"md5": "9f2c1c6a6b7d8e9f0a1b2c3d4e5f6071",
"releaseNotes": [
"新增AI助手",
"优化登录速度",
"修复异常问题"
],
"minVersion": "2.0.0",
"creatorId": "UID202604160001",
"updaterId": "UID202604160001",
"createTime": "2026-08-01T10:20:30",
"updateTime": "2026-08-10T09:15:00",
"publishTime": "2026-08-10T09:15:00",
"formattedCreateTime": "2026-08-01 10:20:30"
}
},
"info": null
}
返回参数示例（无新版本）：
{
"code": 200,
"message": "操作成功",
"data": {
"hasUpdate": false,
"forceUpgrade": false,
"latestVersion": null
},
"info": null
}
← 获取已发布版本详情 获取最新版本（免登录） →