# 获取已发布版本详情

# 目录

# 接口说明

本接口用于按「版本ID」或「版本号」查询某个已正式发布版本的详细信息。

# 接口介绍

该接口适用于以下场景：

客户端已从某处（如服务端下发的配置、升级弹窗历史记录）拿到版本号或版本ID，需要查询该版本的完整信息（下载地址、包大小、MD5、更新说明等）；
需要针对指定历史版本（而非最新版本）查询发布信息，例如渠道包跳转、定向升级。

权限与可见性：本接口仅返回 ONLINE（正式发布）状态的版本，草稿（DRAFT）、测试（TESTING）、已下线（OFFLINE）的版本不会对外暴露；查询不到时返回「未找到已发布的版本」。

# 接口配置入口

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

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

# 接口调用

# 获取已发布版本详情

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

请求示例（按版本号查询，推荐）：

{
  "platform": "ANDROID",
  "versionNumber": "2.1.0"
}

请求示例（按版本ID查询）：

{
  "id": "6650f2b8c1a2b3d4e5f60718"
}

# 请求头：

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

注意：本接口需要登录态，必须携带有效的 Authorization 请求头。

# 请求体（json）：

参数名称	类型	说明	是否必填
id	string	版本记录主键ID（与 versionNumber 二选一，优先使用 id）	否 ※
versionNumber	string	版本号，如 `2.1.0`（与 id 二选一）	否 ※
platform	string	平台类型：WEB/ANDROID/IOS/WINDOWS/MACOS/LINUX/SDK/PLUGIN（按 versionNumber 查询时建议传递，用于精确定位）	否

※ 说明：id 与 versionNumber 至少填写一个，两者都为空时接口返回「版本ID(id)或版本号(versionNumber)不能为空」。

# 响应头：

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

# 返回参数（json）

参数名称	类型	说明
code	number	返回状态码，200 表示成功，其他表示失败
message	string	返回信息描述
data	object	版本详细信息（结构与获取最新版本一致）
data.id	string	版本记录主键ID
data.platform	string	平台类型
data.versionNumber	string	版本号
data.versionCode	number	数字版本号
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.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",
    "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": 18000,
  "message": "业务处理失败:未找到已发布的版本",
  "data": null,
  "info": null
}

← 获取最新版本检查更新（免登录） →