API

POST https://send.meowpush.com/
Content-Type: application/json

公共请求字段

• key：单个 Push Key
• keys：多个 Push Key，用于批量发送，最大 50 个

一个请求中，key 或 keys 不能同时使用。

推送请求字段

字段	类型与限制	默认值	说明
title	字符串，1–256 个字符		通知标题
subtitle	字符串，1–256 个字符		通知副标题；展示方式因平台而异
body	字符串，1–4000 个字符		通知内容
level	passive、active、time-sensitive、critical	active
sound	silent、default、bell、chime、alarm、ding	silent
badge	整数，0–99		绝对角标值；0 清除角标
icon	HTTPS URL，1–2048 个字符		来源头像或图标；呈现能力因平台而异
image	HTTPS URL，1–2048 个字符		通知媒体图片；呈现能力因平台而异
url	URI，1–2048 个字符		要附加的链接，点击通知后跳转
group	字符串，1–64 个字符		将相关通知放入同一分组
collapse_id	[A-Za-z0-9_-]{1,32}		用相同标识替换之前的展示内容
ttl	整数，单位为秒，0–2419200	86400	通知有效时间
data	JSON 对象		传给 App 的自定义数据

除 body 外，消息字段均为可选。

响应

成功处理后的响应会汇总每个最终投递结果：

{
  "notification_id": "019cf5f1-7f2d-7d18-8be1-6f27e1916b52",
  "accepted": 1,
  "failed": 0,
  "results": [
    {
      "key": "mpdv0000000000000001",
      "source_keys": ["mpdv0000000000000001"],
      "status": "accepted",
      "transport": "apns",
      "message_id": "provider-message-id"
    }
  ]
}

字段	说明
notification_id	本次 Push Request 的服务端通知标识
accepted / failed	接受和失败的最终设备数
results[].key	该结果的主来源 Push Key
results[].source_keys	最终解析到同一设备的来源 Push Key 列表
results[].status	accepted 或 failed
results[].transport	实际使用的 apns、fcm、hms、wns 或 unifiedpush；未解析到设备时可能为 null
results[].message_id	上游返回的可选消息标识
results[].reason	失败时的稳定原因代码
results[].retry_at	配额失败时可能返回的最早重试时间

accepted 只表示对应上游推送平台（如 APNs、FCM 等）已接收消息投递，最终送达通常会稍晚于响应时间，并受到上游平台和设备状态的影响。

频率限制

发送频率限制（IP 粒度）：100 次/秒。