Skip to content
v1.0.0 (2026-09-03 16:35)

弹窗公告 (Popups) ​

概述 ​

  • 接口说明:获取系统当前的弹窗广告或紧急通知(通常在访客首次进入网站或会员首次登录后弹出)。
  • 鉴权说明:无需会员登录,但必须携带 Base Token 以识别 Agent。详情请参考基础认证。

1. GET - 获取弹窗列表 ​

  • 路径: /api/system/popups

请求 Header ​

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

请求参数 ​

参数名类型必填说明
deviceString否设备类型 (如 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
    }
  ]
}