v1.0.0 (2026-08-15 18:56)
弹窗公告 (Popups)
概述
- 接口说明:获取系统当前的弹窗广告或紧急通知(通常在访客首次进入网站或会员首次登录后弹出)。
- 鉴权说明:无需会员登录,但必须携带 Base Token 以识别 Agent。详情请参考基础认证。
1. GET - 获取弹窗列表
- 路径:
/api/system/popups
请求 Header
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | String | 是 | Bearer BaseToken (用于识别 Agent) |
Accept-Language | String | 否 | 指定响应语言(如 zh-CN, en-US) |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
device | String | 否 | 设备类型 (如 pc, mobile),用以请求对应尺寸的弹窗图片 |
响应示例
json
{
"code": 0,
"msg": "获取成功",
"data": [
{
"id": 1,
"title": "系统维护通知",
"content": "亲爱的玩家,我们将在本周四凌晨3点进行升级...",
"image_url": "https://cdn.domain.com/popups/maintenance.webp",
"target_url": "",
"show_once": true
}
]
}