Appearance
Google FCM
厂商定位
Firebase Cloud Messaging(FCM)是 Google 提供的 App 设备消息推送能力。MINT 平台中由 dcis-gw(通信交互整合网关)封装为内部接口 POST /internal/v1/fcm-pushes,底层调用 FCM HTTP v1 API,用于开户成功、还款提醒、登录提醒等 App 通知类推送。
能力归属
- 通信能力(App 推送)
核心能力
| 能力 | 接口 | 说明 |
|---|---|---|
| 批量设备推送(内部) | POST /internal/v1/fcm-pushes | 上游 → dcis-gw,body 为消息列表,单次上限 500 条 |
| FCM HTTP v1(底层) | FCM API | dcis-gw 组装报文后调用 Google |
关键约定
- 公共字段:
bizSeqNo(幂等键)、tenantCode、bankCode、sceneCode(如NOTIFICATION_PUSH)。 - 每条消息:
token(FCM 设备令牌)+title/content(上游渲染好的最终文案)+ 透传templateId、messageId。 - dcis-gw 只做透传组装:不查设备表、不做模板渲染,设备 token 与文案由上游负责。
- 响应:
bizRtnCode(000000 / 999999)+sendStatus(SUCCESS / PARTIAL_SUCCESS / FAILED)+ 逐条明细fcmMessageId/errorCode。 - 错误码:
UNREGISTERED(token 失效)、QUOTA_EXCEEDED、UNAVAILABLE、INVALID_ARGUMENT、INTERNAL。
语义注意
- FCM 受理成功 ≠ 设备送达,最终送达以设备回执为准。
- 离线消息 FCM 侧保留至多 24 小时(ttl),过期丢弃。
- token 生命周期由 App 侧维护,
UNREGISTERED需上游触发重新注册并更新设备表。
适用场景
- 开户成功 / 交易 / 还款日提醒 / 登录提醒等 App 通知。
- 与短信(Taifa)互补:在线用户走推送,成本低于短信;触达保证要求高的场景仍以短信为主。
接入待确认
- Firebase 项目归属与 Service Account 凭据管理方式。
- App 侧 token 上报与更新链路(谁维护设备 token 表)。
- 推送文案与模板管理是否后续收口到 dcis-gw。