# あなたのスマホは、 curl 1 行の距離 。

> curl コマンド 1 つでスマホにプッシュ通知を送信。ターミナル、bash スクリプト、cron ジョブのどこからでも Pocket Alert API に POST するだけ。SDK は不要で、無料プランもあります。

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

最終更新日:2026-10-25

curl コマンド 1 行で、スマホにプッシュ通知を送信できます。API キーを添えて Pocket Alert API に title と message を POST すると、1 秒以内に iPhone や Android に届きます。curl が入っているシェル、スクリプト、マシンならどこからでも使えます。

## シェルからポケットまで 3 ステップ

1. **API キーを取得** — 無料で新規登録し、API キーのページでキーを作成して、環境変数としてエクスポートします。
2. **curl で API を呼び出す** — Token ヘッダーを付けて、/v1/messages に title と message を POST します。form-data でも JSON でも構いません。
3. **スマホが震える** — 1 秒以内にプッシュ通知が届きます。&& や || と組み合わせると、成功時や失敗時に通知できます。

## ターミナルからスマホへの通知の流れ

普段からターミナルを使っているなら、Pocket Alert で スマホ を curl 1 行の距離に置けます。SDK もデーモンも、通知サーバーの運用も必要ありません。

- **1 行で送信、SDK 不要** — API キーのヘッダーを付けて title と message を POST するだけです。SDK も OAuth も不要で、curl 以外の依存関係もありません。
- **シェルスクリプト向けの設計** — && と || を組み合わせて、成功時、失敗時、またはその両方で通知できます。crontab や CI スクリプトで使い慣れた書き方がそのまま使えます。
- **JSON もフォームフィールドも可** — JSON にもフォームデータにも対応しており、API がコンテンツタイプを自動判別します。手軽なターミナル用の書き方もスクリプト用の書き方も使えます。
- **メッセージごとに優先度を指定** — 本当に重大なインシデントには level=critical を付けてサイレントモードを突破し、静かに記録だけ残したい場合は level=silent を使います。
- **履歴も自動で保存** — すべてのプッシュ通知は配信統計とともに履歴に残るため、送りっぱなしのスクリプトの通知も失われることはありません。
- **どの環境からでも送信可能** — 同じリクエストを Raspberry Pi、ビルドサーバー、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/ja/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/ja/tools/cli) で同じ API を利用できます。また、単純な HTTP リクエストなので、同じ呼び出しを Python、Go、PowerShell、[cron ジョブ](https://pocketalert.app/ja/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 と form-data(-d key=value 形式)の両方を受け付け、送られた形式を自動で判別します。ターミナルで手早く入力するなら form-data が短く、プログラムから組み立てるなら JSON が扱いやすいです。

### 長時間実行するコマンドが終わったら通知を受け取るには?

コマンドの後ろに && を付けると、成功したときだけ curl ... が実行されます。失敗時の通知には || を、成否にかかわらず通知するには ; を使います。長時間のジョブでは終了コードを取得してメッセージに含めれば、プッシュ通知で結果がわかります。

### コマンドラインから優先度を設定できますか?

-F 'level=critical' を追加すると、Android ではおやすみモードを貫通し、iPhone では集中モードでも届きます。音を鳴らさず記録だけ残したい場合は level=silent を使います。優先度は silent、low、default、high、critical の 5 段階です。

### API キーはどこで取得できますか?

新規登録後、API キーのページで作成できます。スクリプトに直接書き込まず、環境変数やシークレット管理ツールに保存してください。無料プランでは 1 日 50 件のメッセージを送信でき、スクリプトが忙しい日でも十分な量です。
