v1.0.0 (2026-08-15 18:56)
Banners
Overview
- Description: Fetch the list of promotional carousel banners for the homepage, promotions page, or other sections.
- Authentication: No Member Login Required. However, you must provide a Base Token to identify the Agent. See Authentication for details.
1. GET - Get Banners List
- Path:
/api/system/banners
Request Header
| Parameter | Type | Required | Description |
|---|---|---|---|
Authorization | String | Yes | Bearer BaseToken (to identify the Agent) |
Accept-Language | String | No | Target response language (e.g., zh-CN, en-US) |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
position | String | No | Banner placement (e.g., home, promotion), defaults to home banners |
device | String | No | Device type (e.g., pc, mobile) to request the appropriately sized images |
Response Example
json
{
"code": 0,
"msg": "Success",
"data": [
{
"id": 1,
"title": "100% First Deposit Bonus",
"image_url": "https://cdn.domain.com/banners/welcome.webp",
"target_url": "/promotions/1",
"sort": 1
},
{
"id": 2,
"title": "Weekend Carnival",
"image_url": "https://cdn.domain.com/banners/weekend.webp",
"target_url": "/promotions/2",
"sort": 2
}
]
}