ターミナルからスマホへの通知の流れ
普段からターミナルを使っているなら、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 が動く環境であれば、どこからでもスマホに届きます。
シェルからポケットまで 3 ステップ
API キーを取得
無料で新規登録し、API キーのページでキーを作成して、環境変数としてエクスポートします。
curl で API を呼び出す
Token ヘッダーを付けて、/v1/messages に title と message を POST します。form-data でも JSON でも構いません。
スマホが震える
1 秒以内にプッシュ通知が届きます。&& や || と組み合わせると、成功時や失敗時に通知できます。
ターミナルからプッシュ通知を送る
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 と form-data(-d key=value 形式)の両方を受け付け、送られた形式を自動で判別します。ターミナルで手早く入力するなら form-data が短く、プログラムから組み立てるなら JSON が扱いやすいです。
コマンドの後ろに && を付けると、成功したときだけ curl ... が実行されます。失敗時の通知には || を、成否にかかわらず通知するには ; を使います。長時間のジョブでは終了コードを取得してメッセージに含めれば、プッシュ通知で結果がわかります。
-F 'level=critical' を追加すると、Android ではおやすみモードを貫通し、iPhone では集中モードでも届きます。音を鳴らさず記録だけ残したい場合は level=silent を使います。優先度は silent、low、default、high、critical の 5 段階です。
新規登録後、API キーのページで作成できます。スクリプトに直接書き込まず、環境変数やシークレット管理ツールに保存してください。無料プランでは 1 日 50 件のメッセージを送信でき、スクリプトが忙しい日でも十分な量です。