Banner列表
请求URL：
/bannerList
请求方式：
- POST
header：
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Authorization | 是 | string | 授权token |
参数：
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | App唯一标识 |
| udid | 是 | string | 唯一设备ID |
返回示例
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"id": 1,
"thumbImage": "https://muyuhan.s3.amazonaws.com/aiChat/banner/thumb.png",
"orgImage": "https://muyuhan.s3.amazonaws.com/aiChat/banner/original.png",
"sort": 1,
"activitySwitch": 1,
"activityType": 7,
"extendValue": "100",
"startAt": "2026-07-01T00:00:00+08:00",
"endAt": "2026-07-31T23:59:59+08:00",
"appId": "com.coupleuai.chat",
"received": false
},
{
"id": 2,
"thumbImage": "https://muyuhan.s3.amazonaws.com/aiChat/banner/festival_thumb.png",
"orgImage": "https://muyuhan.s3.amazonaws.com/aiChat/banner/festival_original.png",
"sort": 2,
"activitySwitch": 1,
"activityType": 4,
"extendValue": "",
"startAt": "2026-07-01T00:00:00+08:00",
"endAt": "2026-07-31T23:59:59+08:00",
"appId": "com.coupleuai.chat",
"received": false,
"purchasePackageList": [
{
"id": 10,
"price": 999,
"amount": 280,
"giftAmount": 20,
"amountFestival": 300,
"giftAmountFestival": 150,
"productId": "com.coupleuai.chat.app.3",
"limitBuy": 0,
"type": 0,
"channel": 0,
"originalPrice": 0,
"createdAt": 1745688579,
"updatedAt": 1766345901,
"purchased": false
}
]
}
]
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 提示信息 |
| data | array | Banner列表 |
| - id | uint64 | Banner ID |
| - thumbImage | string | Banner缩略图 |
| - orgImage | string | Banner原图 |
| - sort | uint | 排序，升序 |
| - activitySwitch | int8 | 活动开关：1-开启 |
| - activityType | int8 | 活动类型：1-活动banner；2-首冲活动；3-订阅促销；4-节日活动；5-角色推荐；6-分类跳转；7-补偿活动；8-任务入口 |
| - extendValue | string | 扩展值：角色推荐存角色ID；分类跳转存分类ID；补偿活动存补偿钻石数 |
| - startAt | string | 活动开始时间 |
| - endAt | string | 活动结束时间 |
| - appId | string | 适用AppID，可能为空或多个AppID逗号分隔 |
| - received | bool | 是否已领取，补偿活动使用 |
| - purchasePackageList | array | 节日活动套餐列表，仅节日活动且存在节日套餐时返回 |
| -- id | uint | 套餐ID |
| -- price | uint | 套餐价格，单位分 |
| -- amount | uint | 钻石数 |
| -- giftAmount | uint | 附赠钻石数 |
| -- amountFestival | uint | 节日钻石数 |
| -- giftAmountFestival | uint | 节日附赠钻石数 |
| -- productId | string | 支付产品ID |
| -- limitBuy | uint8 | 是否限购：1-是；0-否 |
| -- type | uint8 | 套餐标签：0-无；1-First recharge；2-Recommend；3-Hot；4-Best Deal |
| -- channel | uint8 | 支付渠道 |
| -- originalPrice | uint | 原价，单位分 |
| -- purchased | bool | 是否已购买 |
备注
只返回已开启、未删除、当前时间在活动时间范围内、且匹配当前 appId 的Banner。节日活动Banner在没有节日套餐时不会返回。
错误码: 510 系统异常 800 参数错误