定时发送

立即发送, 稍后送达。

为任意消息设置精确时间或相对延迟,最长可提前 30 天,触发前随时取消。无需 cron 任务,也无需工作进程。

最长可提前 30 天安排随时可取消使用你的时区更新于
你将获得

两种指定时间的方式

以前从脚本里设置提醒,都需要一个一直运行到时间点的进程。现在不用了。

绝对时间

使用 RFC3339、Unix 时间或简单的日期时间给出精确时间戳,选你的语言最方便的那种即可。

相对延迟

也可以给出相对延迟:30m、2h,或直接给秒数。当触发条件是“脚本启动两小时后”时,这种方式很方便。

按你的时区,而不是 UTC

不带偏移的时间按你的账户时区解析,因此 09:00 就是你所在地的上午 9 点。

列出与取消

列出所有待发送的消息,并可在送达前取消任意一条。与调度器的竞争会被干净地处理,不会出现只完成一半的状态。

送达前保持加密

内容在送达前一直加密存储,附件也不例外。取消的消息会连同其文件一起删除。

排程即承诺

优先级和套餐在安排时确定。承诺为关键级别的消息,无论之后发生了什么变化,都会以关键级别送达。

快速开始

三步,一个额外字段

1

添加一个字段

选择一条你已经在发送的消息,加上 send_at 指定时间,或加上 delay 指定偏移。

2

保存 tid

你会收到一个 tid,以及按你的时区和 UTC 给出的实际送达时间。

3

需要时取消

随时可以列出待发送的消息;如果计划有变,使用 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,而不会被悄悄地立即发送。优先级和套餐在安排时就已确定,因此以关键级别安排的消息,仍会以关键级别送达。

删掉 cron 任务,保留提醒。

只需在你原本就在发送的消息上多加一个字段,提醒会在真正需要的时候送达,而不是立刻发出。