命令行

你的手机, 只差一条 curl。

只需一条 curl 命令,就能向你的手机发送推送通知:使用你的密钥,将 title 和 message 以 POST 方式提交到 Pocket Alert API,消息便会在一秒内送达你的 iPhone 或 Android 设备。任何安装了 curl 的 Shell、脚本或机器都能使用。

只需 curl支持 JSON 或 表单数据免费版:每天 50 条更新于
功能

从终端到手机的推送链路

你本就生活在终端里。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 到口袋,三步完成

1

获取 API 密钥

免费注册,在 API 密钥页面创建密钥,并将其导出为环境变量。

2

用 curl 调用 API

携带 Token 请求头,以 POST 方式将 title 和 message 提交到 /v1/messages。支持表单数据或 JSON。

3

手机震动

推送将在一秒内送达。用 && 或 || 串联命令,即可在成功或失败时发出提醒。

从终端发送推送

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 条消息,足够一天繁忙的脚本使用。

让你的终端震动你的口袋。

一个 API 密钥、一行 curl 命令,你接触过的每个终端都能连上你的手机。