Skip to content
v1.0.0 (2026-08-15 18:56)

弹窗公告 (Popups)

概述

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

1. GET - 获取弹窗列表

  • 路径: /api/system/popups

请求 Header

参数名类型必填说明
AuthorizationStringBearer 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
    }
  ]
}