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": "参数错误"
  }
}