两种指定时间的方式
以前从脚本里设置提醒,都需要一个一直运行到时间点的进程。现在不用了。
绝对时间
使用 RFC3339、Unix 时间或简单的日期时间给出精确时间戳,选你的语言最方便的那种即可。
相对延迟
也可以给出相对延迟:30m、2h,或直接给秒数。当触发条件是“脚本启动两小时后”时,这种方式很方便。
按你的时区,而不是 UTC
不带偏移的时间按你的账户时区解析,因此 09:00 就是你所在地的上午 9 点。
列出与取消
列出所有待发送的消息,并可在送达前取消任意一条。与调度器的竞争会被干净地处理,不会出现只完成一半的状态。
送达前保持加密
内容在送达前一直加密存储,附件也不例外。取消的消息会连同其文件一起删除。
排程即承诺
优先级和套餐在安排时确定。承诺为关键级别的消息,无论之后发生了什么变化,都会以关键级别送达。
三步,一个额外字段
添加一个字段
选择一条你已经在发送的消息,加上 send_at 指定时间,或加上 delay 指定偏移。
保存 tid
你会收到一个 tid,以及按你的时区和 UTC 给出的实际送达时间。
需要时取消
随时可以列出待发送的消息;如果计划有变,使用 DELETE 取消即可。
定时发送的工作原理
在普通的创建消息请求中加入 send_at 或 delay。Pocket Alert 不会立即发送,而是存储一份消息的加密快照,交给内部调度器,在正确的时刻以普通推送的形式送出。送达后,这条消息会像其他消息一样出现在你的历史记录中。
你会收到一个 201 响应,其中包含 "scheduled": true、按你的时区和 UTC 分别给出的实际送达时间,以及一个 tid。请保存好它,取消时需要用到。
它能替代什么
证书到期提醒、维护窗口、迁移开始两小时后提醒去检查行数、部署后次日早上的跟进。这些过去都需要 cron 条目或一直运行到时间点的工作进程。现在,只需在你本来就在发送的请求上多加一个字段即可。
边界情况的处理
过去的 send_at 会返回 400,但允许 60 秒的时钟偏差容差,在此范围内的消息会立即发送。服务重启后逾期的消息会延迟送达,而不会被丢弃。附件在安排时上传,并在送达时关联。
常见问题解答
为任意消息添加 send_at 指定精确时间,或添加 delay 指定相对偏移。send_at 接受 RFC3339、Unix 时间戳或简单的 YYYY-MM-DD HH:MM 格式;delay 接受 30m、2h 这样的时长。二者只能选其一,不能同时使用。
最长 30 天。超出范围的请求会被直接拒绝,而不会被悄悄截断。
使用你的账户时区。send_at 设为 2026-08-15 09:00 表示你所在地的上午 9 点,而不是 UTC 的 9 点。如果想避免歧义,可以显式加上时区偏移。
使用 GET /v1/messages/scheduled 列出待发送的消息,使用 DELETE /v1/messages/scheduled/{tid} 取消其中一条。如果已经开始发送,你会收到 409,而不会得到一条只取消了一半的消息。取消时还会删除所有附件。
消息会延迟送达,而不会丢失。如果服务在某个送达时间之后才重启,消息会在下一个调度周期发出。从你安排的那一刻起,内容就以你的密钥加密存储。
定时发送是付费功能。免费套餐使用 send_at 或 delay 的请求会返回 403,而不会被悄悄地立即发送。优先级和套餐在安排时就已确定,因此以关键级别安排的消息,仍会以关键级别送达。