# 你的手机， 只差一条 curl 。

> 用一条 curl 命令向手机发送推送通知。在任意终端、bash 脚本或 cron 任务中 POST 到 Pocket Alert API，无需 SDK，含免费套餐。

<!-- source: https://pocketalert.app/zh/use-cases/curl-push-notifications -->

最后更新：2026-10-25

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

## 从 Shell 到口袋，三步完成

1. **获取 API 密钥** — 免费注册，在 API 密钥页面创建密钥，并将其导出为环境变量。
2. **用 curl 调用 API** — 携带 Token 请求头，以 POST 方式将 title 和 message 提交到 /v1/messages。支持表单数据或 JSON。
3. **手机震动** — 推送将在一秒内送达。用 && 或 || 串联命令，即可在成功或失败时发出提醒。

## 从终端到手机的推送链路

你本就生活在终端里。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 的地方，你的手机就能收到通知。

## 从终端发送推送

### 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 密钥](https://pocketalert.app/zh/account/apikeys)页面创建密钥。如果你更喜欢 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](https://pocketalert.app/zh/tools/cli) 封装了同一个 API。由于它就是普通的 HTTP 请求，同样的调用也能在 Python、Go、PowerShell 或 [cron 任务](https://pocketalert.app/zh/use-cases/cron-job-alerts)中使用。

## 常见问题

### 发送推送的最简 curl 命令是什么？

curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'。就这么简单，无需 SDK，无需客户端库，也无需 OAuth 流程。任何装有 curl 的机器都能发送。

### API 接受 JSON 还是表单字段？

两者都支持。该端点同时接受 application/json 和表单数据（-d 键值对），并自动识别你发送的格式。在终端里输入表单数据更简短；以编程方式构建请求时，JSON 更方便。

### 长时间运行的命令结束时，如何收到通知？

用 && 把命令连接起来：make build && curl … 只会在成功时触发。用 || 处理失败告警，或用 ; 无论结果如何都发送通知。对于耗时较长的任务，可以捕获退出码并放入消息中，这样推送就能告诉你发生了什么。

### 能否在命令行中设置优先级？

添加 -F 'level=critical'，推送就会在 Android 上绕过勿扰模式，并在 iPhone 上突破专注模式。如果只想留下记录而不发出声音，可使用 level=silent。共有五个级别：silent、low、default、high、critical。

### API 密钥从哪里获取？

注册后在 API 密钥页面创建。请将其放入环境变量或密钥管理器中，不要硬编码在脚本里。免费套餐每天包含 50 条消息，足够一天繁忙的脚本使用。
