Download Markdown

PWA 推送接口

本节描述 PWA Web Push 相关接口：上报 / 注销 FCM（Firebase Cloud Messaging）设备 token，用于后台推送任务向玩家下发通知。

接入流程：玩家在 PWA 中授予通知权限 → 前端用 Firebase Web SDK getToken(...) 拿到设备 token → 调用 /pwa/subscribe 上报；退出登录或切换账号前调用 /pwa/unsubscribe 清空。

上报推送 token

上报当前设备的 FCM 推送 token，幂等覆盖当前会员上一次保存的 token。需登录态。

URL: POST /pwa/subscribe

输入:

字段 类型 必填 说明
token string 是 FCM 设备 token，长度 ≥ 1

输出: 无

上报和普通 token 续期仅维护订阅，不发放奖励。通知任务奖励由前端在用户主动参与时另行调用活动领取接口。

失败：

  • token 为空：推送 token 不能为空

注销推送 token

清空当前会员的 FCM 推送 token，停止后续推送下发。需登录态。

URL: POST /pwa/unsubscribe

输入: 无

输出: 无