当前为开发环境,请使用 App 为此服务器注册生成的 Webhook。
更新与撤回
状态更新时,让一条通知不断变化,比堆上十条更好读。给相关消息一个 id,就可以替换、撤回或让它过期。
给相关消息分组#
group 会把通知归到通知中心和历史记录中的同一个标题下。每个任务或主题用一个值,例如 backups 或 deploy-api。在 iPhone 上,可以通过通知的操作把吵闹的分组静音 10 分钟或 1 小时。
替换消息#
发送一条 id 相同的新通知。旧通知会从通知中心移除,历史记录只保留最新版本。
curl https://push.breezelabs.dev/v1/send \
-H 'Authorization: Bearer YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"id":"deploy-42","title":"Deploy","body":"Step 3 of 5: running migrations"}'
id 最长 128 个字符。请使用稳定的值,例如任务编号。
撤回消息#
带上同一个 id 发送 delete=1。Breeze 会把这条通知从通知中心和历史记录中删除。
curl https://push.breezelabs.dev/v1/send \
-H 'Authorization: Bearer YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"id":"deploy-42","delete":1}'
撤回以后台更新的方式送达。手机处于低电量模式或 App 被强制退出时,系统可能延迟处理,因此不要依赖它处理敏感内容。
让消息过期#
ttl 设置消息在历史记录中保留的秒数,到期后自动消失。ttl=0 表示只显示通知、不保存。
https://push.breezelabs.dev/YOUR_KEY/One-time%20code%20482193?ttl=300
在 Android 上,ttl 同时限制 Google 尝试投递的时长:最长四周,默认四周。
不存入历史记录#
在 iOS 上发送 isArchive=0,这条消息就不会进入历史记录。要更改所有消息的默认行为,请在 App 的设置中选择历史记录的保留时长,或关闭保存。
合并待投递的更新#
手机离线时,collapse_id 相同的待投递通知只保留最新一条,避免手机上线后收到一连串过时的更新。它不保证只投递一次。