コマンドライン

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

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

必要なのは curl だけJSON または form-data無料プラン: 1 日 50 件 更新
機能

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

普段からターミナルを使っているなら、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 ステップ

1

API キーを取得

無料で新規登録し、API キーのページでキーを作成して、環境変数としてエクスポートします。

2

curl で API を呼び出す

Token ヘッダーを付けて、/v1/messages に title と message を POST します。form-data でも JSON でも構いません。

3

スマホが震える

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 ジョブからも実行できます。

FAQ

よくある質問

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 件のメッセージを送信でき、スクリプトが忙しい日でも十分な量です。

ターミナルからポケットを震わせましょう。

API キーと curl の 1 行があれば、触れるすべてのターミナルからスマホに通知を届けられます。