Skip to content
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

ParameterTypeRequiredDescription
AuthorizationStringYesBearer BaseToken (to identify the Agent)
Accept-LanguageStringNoTarget response language (e.g., zh-CN, en-US)

Request Parameters

ParameterTypeRequiredDescription
positionStringNoBanner placement (e.g., home, promotion), defaults to home banners
deviceStringNoDevice 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
    }
  ]
}