分页查找banner列表

开发中

GET

/promote/banner/list

请求参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/promote/banner/list?pageNum=1&pageSize=10&bannerName=广告&status=0' \
--header 'Accept: application/json' \
--header 'clientid: {{clientid}}' \
--header 'Authorization: {{authorization}}'

返回响应

🟢200成功

application/json

Body

示例

{
    "total": 11,
    "rows": [
        {
            "id": "2015684832671084545",
            "bannerType": "BANNER",
            "bannerName": "广告1111",
            "bannerAreaList": [
                {
                    "label": "个人中心",
                    "value": "PERSONAL_CENTER"
                },
                {
                    "label": "首页",
                    "value": "HOME_CENTER"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
            "linkType": "H5_LINK",
            "linkUrl": "https://www.baidu.com/",
            "imgLangList": [
                {
                    "bannerId": "2015684832671084545",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
                    "linkUrl": "https://www.baidu.com/",
                    "linkType": "H5_LINK",
                    "roomNo": null
                },
                {
                    "bannerId": "2015684832671084545",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "2015684832671084545",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "男",
                    "value": "man"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2026-01-28 00:00:00",
            "showEndTime": "2026-02-27 23:59:59",
            "bannerWeight": 1,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2026-01-26 15:14:48",
            "typeStr": "个人中心",
            "linkTypeName": "H5链接",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "2015684286237159426",
            "bannerType": "BANNER",
            "bannerName": "广告1111",
            "bannerAreaList": [
                {
                    "label": "个人中心",
                    "value": "PERSONAL_CENTER"
                },
                {
                    "label": "首页",
                    "value": "HOME_CENTER"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
            "linkType": "H5_LINK",
            "linkUrl": "https://www.baidu.com/",
            "imgLangList": [
                {
                    "bannerId": "2015684286237159426",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
                    "linkUrl": "https://www.baidu.com/",
                    "linkType": "H5_LINK",
                    "roomNo": null
                },
                {
                    "bannerId": "2015684286237159426",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "2015684286237159426",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "男",
                    "value": "man"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2025-07-28 00:00:00",
            "showEndTime": "2025-08-27 23:59:59",
            "bannerWeight": 1,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2026-01-26 15:12:38",
            "typeStr": "个人中心",
            "linkTypeName": "H5链接",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "2015676867649224705",
            "bannerType": "BANNER",
            "bannerName": "广告",
            "bannerAreaList": [
                {
                    "label": "个人中心",
                    "value": "PERSONAL_CENTER"
                },
                {
                    "label": "首页",
                    "value": "HOME_CENTER"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
            "linkType": "H5_LINK",
            "linkUrl": "https://www.baidu.com/",
            "imgLangList": [
                {
                    "bannerId": "2015676867649224705",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
                    "linkUrl": "https://www.baidu.com/",
                    "linkType": "H5_LINK",
                    "roomNo": null
                },
                {
                    "bannerId": "2015676867649224705",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "2015676867649224705",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "男",
                    "value": "man"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2025-07-28 00:00:00",
            "showEndTime": "2025-08-27 23:59:59",
            "bannerWeight": 1,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2026-01-26 14:43:09",
            "typeStr": "个人中心",
            "linkTypeName": "H5链接",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "2015676289497972738",
            "bannerType": "BANNER",
            "bannerName": "广告-1",
            "bannerAreaList": [
                {
                    "label": "个人中心",
                    "value": "PERSONAL_CENTER"
                },
                {
                    "label": "首页",
                    "value": "HOME_CENTER"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
            "linkType": "H5_LINK",
            "linkUrl": "https://www.baidu.com/",
            "imgLangList": [
                {
                    "bannerId": "2015676289497972738",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
                    "linkUrl": "https://www.baidu.com/",
                    "linkType": "H5_LINK",
                    "roomNo": null
                },
                {
                    "bannerId": "2015676289497972738",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "2015676289497972738",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "男",
                    "value": "man"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2025-07-28 00:00:00",
            "showEndTime": "2025-08-27 23:59:59",
            "bannerWeight": 1,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2026-01-26 06:42:10",
            "typeStr": "个人中心",
            "linkTypeName": "H5链接",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "1989222790955315201",
            "bannerType": "FLOATING_AD",
            "bannerName": "新增悬浮广告-男",
            "bannerAreaList": [
                {
                    "label": "首页悬浮",
                    "value": "HOMEPAGE_FLOATING"
                },
                {
                    "label": "聊天室悬浮",
                    "value": "CHAT_ROOM_FLOATING"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/11/14/0a9fe3e275424663b4da11316b51dc29.png",
            "linkType": "VIP_PAGE",
            "linkUrl": "",
            "imgLangList": [
                {
                    "bannerId": "1989222790955315201",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/11/14/0a9fe3e275424663b4da11316b51dc29.png",
                    "linkUrl": "",
                    "linkType": "VIP_PAGE",
                    "roomNo": null
                },
                {
                    "bannerId": "1989222790955315201",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "1989222790955315201",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "男",
                    "value": "man"
                }
            ],
            "phoneType": null,
            "exposureCount": 10,
            "showStartTime": "2025-11-13 00:00:00",
            "showEndTime": "2025-12-22 00:00:00",
            "bannerWeight": 11111,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2025-11-21 11:23:35",
            "typeStr": "个人中心",
            "linkTypeName": "VIP",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "1989222932311748609",
            "bannerType": "FLOATING_AD",
            "bannerName": "1115新增悬浮广告-女",
            "bannerAreaList": [
                {
                    "label": "首页悬浮",
                    "value": "HOMEPAGE_FLOATING"
                },
                {
                    "label": "聊天室悬浮",
                    "value": "CHAT_ROOM_FLOATING"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/11/14/dfeff01b095e4926985b277497ef5aa4.png",
            "linkType": "ANCHOR_CENTER",
            "linkUrl": "",
            "imgLangList": [
                {
                    "bannerId": "1989222932311748609",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/11/14/dfeff01b095e4926985b277497ef5aa4.png",
                    "linkUrl": "",
                    "linkType": "ANCHOR_CENTER",
                    "roomNo": null
                },
                {
                    "bannerId": "1989222932311748609",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "1989222932311748609",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "女",
                    "value": "woman"
                }
            ],
            "phoneType": null,
            "exposureCount": 8,
            "showStartTime": "2025-11-14 00:00:00",
            "showEndTime": "2025-12-29 00:00:00",
            "bannerWeight": 2332,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2025-11-21 11:17:09",
            "typeStr": "个人中心",
            "linkTypeName": "主播中心",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "1989178606881910786",
            "bannerType": "FLOATING_AD",
            "bannerName": "test首页悬浮广告",
            "bannerAreaList": [
                {
                    "label": "首页悬浮",
                    "value": "HOMEPAGE_FLOATING"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/11/14/2d2291daae9649458754ad1cf8292f27.png",
            "linkType": "QUICK_MATCH_PAGE",
            "linkUrl": "",
            "imgLangList": [
                {
                    "bannerId": "1989178606881910786",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/11/14/2d2291daae9649458754ad1cf8292f27.png",
                    "linkUrl": "",
                    "linkType": "QUICK_MATCH_PAGE",
                    "roomNo": null
                },
                {
                    "bannerId": "1989178606881910786",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "1989178606881910786",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "男",
                    "value": "man"
                },
                {
                    "label": "女",
                    "value": "woman"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2025-11-05 00:00:00",
            "showEndTime": "2025-11-28 00:00:00",
            "bannerWeight": 22,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2025-11-14 11:48:32",
            "typeStr": "个人中心",
            "linkTypeName": "速配页",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "1988510872229642241",
            "bannerType": "FLOATING_AD",
            "bannerName": "悬浮广告-3",
            "bannerAreaList": [
                {
                    "label": "首页悬浮",
                    "value": "HOMEPAGE_FLOATING"
                },
                {
                    "label": "聊天室悬浮",
                    "value": "CHAT_ROOM_FLOATING"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
            "linkType": "ANCHOR_CENTER",
            "linkUrl": "https://www.baidu.com/",
            "imgLangList": [
                {
                    "bannerId": "1988510872229642241",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
                    "linkUrl": "https://www.baidu.com/",
                    "linkType": "ANCHOR_CENTER",
                    "roomNo": null
                },
                {
                    "bannerId": "1988510872229642241",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "1988510872229642241",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "女",
                    "value": "woman"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2025-11-13 00:00:00",
            "showEndTime": "2025-11-13 23:59:59",
            "bannerWeight": 1,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2025-11-20 18:59:43",
            "typeStr": "个人中心",
            "linkTypeName": "主播中心",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "1988507073586921474",
            "bannerType": "FLOATING_AD",
            "bannerName": "悬浮广告-1",
            "bannerAreaList": [
                {
                    "label": "首页悬浮",
                    "value": "HOMEPAGE_FLOATING"
                },
                {
                    "label": "聊天室悬浮",
                    "value": "CHAT_ROOM_FLOATING"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
            "linkType": "ANCHOR_CENTER",
            "linkUrl": "https://www.baidu.com/",
            "imgLangList": [
                {
                    "bannerId": "1988507073586921474",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
                    "linkUrl": "https://www.baidu.com/",
                    "linkType": "ANCHOR_CENTER",
                    "roomNo": null
                },
                {
                    "bannerId": "1988507073586921474",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "1988507073586921474",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "女",
                    "value": "woman"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2025-11-13 00:00:00",
            "showEndTime": "2025-11-13 23:59:59",
            "bannerWeight": 1,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2025-11-20 18:59:41",
            "typeStr": "个人中心",
            "linkTypeName": "主播中心",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        },
        {
            "id": "1988510850733834242",
            "bannerType": "FLOATING_AD",
            "bannerName": "悬浮广告-2",
            "bannerAreaList": [
                {
                    "label": "首页悬浮",
                    "value": "HOMEPAGE_FLOATING"
                },
                {
                    "label": "聊天室悬浮",
                    "value": "CHAT_ROOM_FLOATING"
                }
            ],
            "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
            "linkType": "ANCHOR_CENTER",
            "linkUrl": "https://www.baidu.com/",
            "imgLangList": [
                {
                    "bannerId": "1988510850733834242",
                    "lang": "en-US",
                    "imgUrl": "http://duikan-test-1305255132.cos.ap-shanghai.myqcloud.com/2025/03/12/22e93e1b5dc44a60a48f756eb9f13154.png",
                    "linkUrl": "https://www.baidu.com/",
                    "linkType": "ANCHOR_CENTER",
                    "roomNo": null
                },
                {
                    "bannerId": "1988510850733834242",
                    "lang": "vi-VN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                },
                {
                    "bannerId": "1988510850733834242",
                    "lang": "zh-CN",
                    "imgUrl": null,
                    "linkUrl": null,
                    "linkType": null,
                    "roomNo": null
                }
            ],
            "sexVisibilityList": [
                {
                    "label": "女",
                    "value": "woman"
                }
            ],
            "phoneType": null,
            "exposureCount": 0,
            "showStartTime": "2025-11-13 00:00:00",
            "showEndTime": "2025-11-13 23:59:59",
            "bannerWeight": 1,
            "type": "PERSONAL_CENTER",
            "language": "zh_CN",
            "status": 0,
            "enable": null,
            "createTime": "2025-11-20 18:56:04",
            "typeStr": "个人中心",
            "linkTypeName": "主播中心",
            "languageStr": "简体中文",
            "phoneTypeStr": null
        }
    ],
    "code": 200,
    "msg": "查询成功"
}

修改于 2026-01-26 06:57:56

获取跳转类型

新增banner或开屏广告