# 获取最新版本（免登录）

# 目录

# 接口说明

本接口用于在未登录状态下获取指定平台下最新正式发布的版本信息。

# 接口介绍

本接口与获取最新版本的业务逻辑、请求参数、返回结构完全一致，唯一区别是不需要登录态，适用于以下场景：

官网 / 应用商店 / 下载页展示各平台最新版本号与下载地址（无用户体系）；
客户端启动页、登录页展示最新版本信息；
游戏厂商在自己站点的下载入口直接拉取最新版本。

与获取最新版本的区别：

获取最新版本（本接口）获取最新版本（需登录）

接口路径 /open/public/latest /open/latest

是否需要登录态否是

Authorization 请求头不需要需要

请求 / 响应结构完全相同完全相同

	获取最新版本（本接口）	获取最新版本（需登录）
接口路径	`/open/public/latest`	`/open/latest`
是否需要登录态	否	是
`Authorization` 请求头	不需要	需要
请求 / 响应结构	完全相同	完全相同

服务端仅返回 ONLINE（正式发布）状态的版本；同一平台存在多个已发布版本时，返回数字版本号最大的那一个（服务端会自动保证同一平台只有一个正式发布版本，新版本发布时旧版本自动下线）。

与检查更新（免登录）的区别：check 需要传客户端当前版本并返回「是否有更新/是否强制升级」；latest 只返回最新版本信息，不判断更新关系。

# 接口配置入口

登录氦闪开发者平台 (opens new window)
"接口管理" 》 "平台接口" 》 "模块API" 》 "版本管理模块"
选择 "版本中心服务获取最新版本(免登录)"
右上角选择开启

提示：此接口数据持久化使用 MongoDB 数据库，请确保已配置相关数据源。本接口无需登录态，请求头不需要 Authorization。多租户数据源按请求头 APPID 自动切换，请求体无需传 appid。

# 接口调用

# 获取最新版本（免登录）

接口地址：https://lb/business-service/hiasoon-versionmanagercenter/open/public/latest
返回格式：json
请求方式：POST
请求示例：

{
  "platform": "ANDROID"
}

# 请求头：

参数名称	类型	说明	是否必填
APPID	string	开发者平台分配的应用APPID	是
_t	number	请求时间戳（毫秒级）	是
_s	string	签名信息，用于接口安全验证	是
_n	string	随机数	是

注意：本接口为免登录接口，不需要 Authorization 请求头。

# 请求体（json）：

参数名称	类型	说明	是否必填
platform	string	平台类型：WEB/ANDROID/IOS/WINDOWS/MACOS/LINUX/SDK/PLUGIN	是

# 响应头：

参数名称	类型	说明	是否必填
connectionid	string	本次请求的唯一标识	是
_t	number	响应时间戳（毫秒级）	是
_s	string	响应签名信息，用于防篡改校验	是
_n	string	随机数（与本次请求的值一致）	是

# 返回参数（json）

返回结构与获取最新版本完全一致：

参数名称	类型	说明
code	number	返回状态码，200 表示成功，其他表示失败
message	string	返回信息描述（无已发布版本时为「暂无已发布版本」）
data	object	最新版本信息，无已发布版本时为 null
data.id	string	版本记录主键ID
data.platform	string	平台类型
data.versionNumber	string	版本号，如 `2.1.0`
data.versionCode	number	数字版本号，如 `20100`
data.status	string	发布状态（`ONLINE`）
data.upgradeType	string	升级类型：NONE/OPTIONAL/FORCE
data.downloadUrl	string	安装包下载地址
data.packageSize	number	安装包大小（字节）
data.md5	string	安装包 MD5 校验值
data.releaseNotes	array	更新说明（字符串数组）
data.minVersion	string	最低支持版本
data.creatorId	string	创建人ID
data.updaterId	string	修改人ID
data.createTime	string	创建时间
data.updateTime	string	更新时间
data.publishTime	string	正式发布时间
data.formattedCreateTime	string	格式化后的创建时间（`yyyy-MM-dd HH:mm:ss`）
info	object	附加信息，一般为 null

返回参数示例：

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "id": "6650f2b8c1a2b3d4e5f60718",
    "platform": "ANDROID",
    "versionNumber": "2.1.0",
    "versionCode": 20100,
    "status": "ONLINE",
    "upgradeType": "OPTIONAL",
    "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": null,
  "info": null
}

← 检查更新（免登录） API文档说明 →