# PWA 推送接口

> 本节描述 PWA Web Push 相关接口：上报 / 注销 FCM（Firebase Cloud Messaging）设备 token，用于后台推送任务向玩家下发通知。
>
> 接入流程：玩家在 PWA 中授予通知权限 → 前端用 Firebase Web SDK `getToken(...)` 拿到设备 token → 调用 [`/pwa/subscribe`](#subscribe) 上报；退出登录或切换账号前调用 [`/pwa/unsubscribe`](#unsubscribe) 清空。

---

## 上报推送 token {#subscribe}

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

**URL:** `POST` /pwa/subscribe

**输入:**

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

**输出:** 无

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

**失败：**

- token 为空：`推送 token 不能为空`

---

## 注销推送 token {#unsubscribe}

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

**URL:** `POST` /pwa/unsubscribe

**输入:** 无

**输出:** 无