console-center-aggregate 接口文档

更新时间：2026-05-21 16:57:58

查询商城套餐版本详情

接口地址

GET /v3/console/mall-package-version/get

接口说明

查询商城套餐版本详情。

当前接口由 console-center-aggregate 提供，对接商城侧 MallApiClient#getVersionDetail，返回指定版本 ID 对应的版本信息。

请求参数

参数名	类型	必填	说明
`id`	`Integer`	是	商城套餐版本 ID

说明：

id 为空时，接口返回参数错误。
当前接口本身不做额外业务转换，主要透传商城版本详情数据。

请求示例

GET /v3/console/mall-package-version/get?id=1001

返回结构

返回类型：ResponseVO<VersionVO>

ResponseVO 字段

字段名	类型	说明
`code`	`Integer`	状态码，成功一般为 `200`
`status`	`String`	`success` / `error`
`requestId`	`String`	请求 ID
`error`	`Object`	失败信息
`data`	`VersionVO`	返回数据

VersionVO 字段

字段名	类型	说明
`id`	`Integer`	版本 ID
`name`	`String`	版本名称
`code`	`String`	版本编码
`category`	`String`	版本分类编码
`categoryDisplay`	`String`	版本分类显示名称
`crmProductId`	`String`	CRM 产品 ID
`description`	`String`	版本描述
`sortOrder`	`Integer`	排序值
`mainPackageType`	`String`	主套餐类型编码
`mainPackageTypeDisplay`	`String`	主套餐类型显示名称
`concurrentSubType`	`String`	并发子类型编码
`concurrentSubTypeDisplay`	`String`	并发子类型显示名称
`mainPackageQuotaDisplay`	`String`	主套餐配额显示值
`priceCycle`	`String`	价格周期编码
`priceCycleValue`	`Integer`	价格周期值
`priceCycleDisplay`	`String`	价格周期显示名称
`unitPrice`	`String`	单价
`featureSwitches`	`List<FeatureSwitchVO>`	功能开关列表
`resourceQuotas`	`List<ResourceQuota>`	资源配额列表
`packageTemplateId`	`Integer`	套餐模板 ID
`packageTemplateName`	`String`	套餐模板名称
`salesChannels`	`List<Integer>`	销售渠道 ID 列表
`salesChannelsInfo`	`List<SalesChannelInfo>`	销售渠道详情列表
`createdAt`	`String`	创建时间
`updatedAt`	`String`	更新时间

FeatureSwitchVO 字段

字段名	类型	说明
`code`	`String`	功能编码
`open`	`Boolean`	功能是否开启
`functionType`	`String`	配置类型
`value`	`String`	扩展值
`sys`	`String`	产品编码

ResourceQuota 字段

字段名	类型	说明
`type`	`String`	资源类型
`unit`	`String`	资源单位
`quota`	`Integer`	资源配额值
`resourceCode`	`String`	资源编码
`resourceName`	`String`	资源名称
`crmProductId`	`String`	CRM 产品 ID
`isMainPackage`	`Boolean`	是否主套餐资源

SalesChannelInfo 字段

字段名	类型	说明
`id`	`Integer`	销售渠道 ID
`name`	`String`	销售渠道名称

成功返回示例

{
  "code": 200,
  "status": "success",
  "data": {
    "id": 1001,
    "name": "直播标准版",
    "code": "live_standard_v1",
    "category": "live",
    "categoryDisplay": "直播",
    "crmProductId": "CRM1001",
    "description": "直播标准套餐版本",
    "sortOrder": 1,
    "mainPackageType": "duration",
    "mainPackageTypeDisplay": "直播分钟数",
    "concurrentSubType": "normal",
    "concurrentSubTypeDisplay": "标准并发",
    "mainPackageQuotaDisplay": "50000分钟",
    "priceCycle": "year",
    "priceCycleValue": 1,
    "priceCycleDisplay": "1年",
    "unitPrice": "120000",
    "resourceQuotas": [
      {
        "type": "live_duration",
        "unit": "minute",
        "quota": 50000,
        "resourceCode": "LIVE_DURATION",
        "resourceName": "直播分钟数",
        "crmProductId": "CRM-R-1001",
        "isMainPackage": true
      }
    ],
    "salesChannels": [
      1,
      2
    ],
    "salesChannelsInfo": [
      {
        "id": 1,
        "name": "控制台"
      }
    ],
    "createdAt": "2026-05-21 16:00:00",
    "updatedAt": "2026-05-21 16:00:00"
  }
}

失败返回示例

{
  "code": 400,
  "status": "error",
  "error": {
    "code": 400,
    "desc": "参数错误"
  }
}

POLYV 帮助中心