请求Firebase HTTP v1 iOS JSON通知负载正确语法（含静默通知）

开发者阿泽

2026-6-17

Firebase HTTP v1 版本 iOS 通知负载正确语法

静默通知（后台触发）

以下是符合Firebase v1规范的iOS静默通知格式，匹配你旧版需求：

{
  "message": {
    "token": "%MobileUser.DeviceId%",
    "apns": {
      "headers": {
        "apns-push-type": "background",
        "apns-priority": "5"
      },
      "payload": {
        "aps": {
          "content_available": true
        },
        "data": {
          "notificationId": "%Some.Id%",
          "KeyOne": "%Val.One%",
          "KeyTwo": "%Val.Two%"
        }
      }
    }
  }
}

核心注意事项：

设备token直接放在message层级，不要嵌套进aps
apns-push-type和apns-priority属于APNS请求头，必须放在apns.headers下，不能塞进payload
content_available必须在aps对象内，设为true才能触发iOS后台处理
自定义数据data放在apns.payload同级，和旧版存放逻辑一致

普通可见通知

如果是需要弹出提示的普通通知，格式如下：

{
  "message": {
    "token": "%MobileUser.DeviceId%",
    "apns": {
      "headers": {
        "apns-push-type": "alert"
      },
      "payload": {
        "aps": {
          "alert": {
            "title": "你的通知标题",
            "body": "通知具体内容"
          },
          "sound": "default"
        },
        "data": {
          "notificationId": "%Some.Id%",
          "KeyOne": "%Val.One%"
        }
      }
    }
  }
}