从终端到手机的推送链路
你本就生活在终端里。Pocket Alert 让你的手机离它只有一条 curl 命令的距离,无需 SDK,无需守护进程,也无需运行通知服务器。
一行命令,无需 SDK
携带 API 密钥请求头,以 POST 方式提交 title 和 message。无需 SDK,无需 OAuth,除 curl 本身外没有其他依赖。
为 Shell 脚本而生
用 && 和 || 串联命令,可在成功、失败或两者都发生时推送。你的 crontab 和 CI 脚本早已熟悉这种写法。
JSON 或表单字段
支持 JSON 或表单数据,API 会自动识别内容类型,因此终端里的快速写法和脚本中的完整写法都能正常工作。
每条消息单独设置优先级
添加 level=critical,即可在真正的故障发生时突破静音模式;使用 level=silent,则可留下安静的记录而不会震动。
包含历史记录
每条推送都会进入你的历史记录,并附带投递统计,因此脚本发出后被遗忘的消息也不会真正丢失。
任何机器都能用
同一请求可在树莓派、构建服务器、VPS 或 WSL 中运行,只要能运行 curl 的地方,你的手机就能收到通知。
从 Shell 到口袋,三步完成
获取 API 密钥
免费注册,在 API 密钥页面创建密钥,并将其导出为环境变量。
用 curl 调用 API
携带 Token 请求头,以 POST 方式将 title 和 message 提交到 /v1/messages。支持表单数据或 JSON。
手机震动
推送将在一秒内送达。用 && 或 || 串联命令,即可在成功或失败时发出提醒。
从终端发送推送
1. 一行命令
curl -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-F 'title=Deploy finished' -F 'message=v2.4.1 is live on production'
在 API 密钥页面创建密钥。如果你更喜欢 JSON,同样支持:
curl -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title":"Deploy finished","message":"v2.4.1 is live on production"}'
2. 串联到任何命令后
当耗时任务完成时通知你,或仅在失败时通知:
# push when the build succeeds
make release && curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' -F 'title=Build OK' -F 'message=make release finished'
# push only on failure, and make it loud
./migrate.sh || curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-F 'title=Migration FAILED' -F 'message=migrate.sh exited non-zero' -F 'level=critical'
3. 封装成函数
将以下内容加入你的 .bashrc / .zshrc,从此不必再输入 URL:
notify() {
curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
-H "Token: $POCKETALERT_KEY" \
--form-string "title=$1" --form-string "message=$2" --form-string "level=${3:-default}" > /dev/null
}
# usage
long_task; notify "long_task done" "exit code $?"
notify "Disk warning" "/dev/sda1 at 91%" high
更喜欢现成的可执行程序?Pocket Alert CLI 封装了同一个 API。由于它就是普通的 HTTP 请求,同样的调用也能在 Python、Go、PowerShell 或 cron 任务中使用。
常见问题解答
curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'。就这么简单,无需 SDK,无需客户端库,也无需 OAuth 流程。任何装有 curl 的机器都能发送。
两者都支持。该端点同时接受 application/json 和表单数据(-d 键值对),并自动识别你发送的格式。在终端里输入表单数据更简短;以编程方式构建请求时,JSON 更方便。
用 && 把命令连接起来:make build && curl … 只会在成功时触发。用 || 处理失败告警,或用 ; 无论结果如何都发送通知。对于耗时较长的任务,可以捕获退出码并放入消息中,这样推送就能告诉你发生了什么。
添加 -F 'level=critical',推送就会在 Android 上绕过勿扰模式,并在 iPhone 上突破专注模式。如果只想留下记录而不发出声音,可使用 level=silent。共有五个级别:silent、low、default、high、critical。
注册后在 API 密钥页面创建。请将其放入环境变量或密钥管理器中,不要硬编码在脚本里。免费套餐每天包含 50 条消息,足够一天繁忙的脚本使用。