# 获取最新版本

# 目录

# 接口说明

本接口用于获取指定平台下最新正式发布的版本信息。

# 接口介绍

该接口适用于「不需要传当前版本、只想拿到最新版本」的场景，例如：

官网/应用商店展示各平台最新版本号与下载地址；
客户端在启动页展示最新版本信息、或做「手动检查更新」时直接拉取最新版本；
运营侧快速确认某平台当前线上版本。

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

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

# 接口配置入口

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

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

# 接口调用

# 获取最新版本

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

{
  "platform": "ANDROID"
}

# 请求头：

参数名称	类型	说明	是否必填
APPID	string	开发者平台分配的应用APPID	是
_t	number	请求时间戳（毫秒级）	是
_s	string	签名信息，用于接口安全验证	是
_n	string	随机数	是
Authorization	string	Bearer {token}，访问令牌（本接口必须登录）	是

注意：本接口需要登录态，必须携带有效的 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
}

← 检查更新获取已发布版本详情 →