首页轮播图 (Banners)

概述

• 接口说明：获取首页顶部、优惠页或其他位置的活动轮播广告图列表。
• 鉴权说明：无需会员登录，但必须携带 Base Token 以识别 Agent。详情请参考基础认证。

1. GET - 获取轮播图列表

• 路径: /api/system/banners

请求 Header

参数名	类型	必填	说明
Authorization	String	是	Bearer BaseToken (用于识别 Agent)
Accept-Language	String	否	指定响应语言（如 zh-CN, en-US）

请求参数

参数名	类型	必填	说明
position	String	否	轮播图位置 (如 home, promotion)，默认获取首页轮播图
device	String	否	设备类型 (如 pc, mobile)，用以请求对应尺寸的图片

响应示例

{
  "code": 0,
  "msg": "获取成功",
  "data": [
    {
      "id": 1,
      "title": "首充送100%",
      "image_url": "https://cdn.domain.com/banners/welcome.webp",
      "target_url": "/promotions/1",
      "sort": 1
    },
    {
      "id": 2,
      "title": "周末狂欢",
      "image_url": "https://cdn.domain.com/banners/weekend.webp",
      "target_url": "/promotions/2",
      "sort": 2
    }
  ]
}