プッシュ通知 API とは?必要になるのはどんなとき?

プッシュ通知 API は、コードからの指示に応じてスマホのロック画面にメッセージを表示させる Web サービスです。タイトルと本文を含む HTTP リクエストを 1 回送ると、サービスがそれを Apple や Google に渡し、どのアプリも開いていなくても数秒以内にスマホに表示されます。
基本はこれだけです。細かい違いは、通知の受け手が誰か、そして配信の仕組みのどこまでを自分で持ちたいかにあります。
同じ名前で呼ばれる 2 種類のもの
「プッシュ通知 API」で検索すると、ほとんど重ならない 2 種類のサービスが出てきます。
ユーザーにプッシュするプラットフォーム。 Firebase Cloud Messaging、Apple Push Notification service、OneSignal などが該当します。モバイルアプリを開発して App Store と Google Play に公開し、インストールされた各端末からデバイストークンを集めて、何千人ものユーザーに製品通知やマーケティング通知を送ります。API は長いプロジェクトの最後の工程です。
自分にプッシュするサービス。 Pocket Alert、Pushover、ntfy などが該当します。アプリはすでにあり、自分のスマホにインストールしてAPI キーを取得すれば、スクリプト、サーバー、その他のサービスからアラートを送れます。公開作業もトークンの収集も不要です。デプロイが終わった、バックアップが失敗した、入金があった、といった通知に向いています。
このガイドは後者を扱います。コンシューマー向けアプリを作ってそのユーザーに届けたいなら前者が必要で、以下の内容の多くは当てはまりません。
送信したときに起こること
主に目に見えない 4 つのステップがあります。
- コードが、タイトル、メッセージ、API キーを含む HTTPS リクエストをサービスに送ります。
- サービスが API キーを確認し、メッセージを保存して、送り先を決めます。どのデバイスに、どの優先度で送るかです。
- サービスが通知をプラットフォームのプッシュネットワークに渡します。iPhone では APNs、Android では Firebase Cloud Messaging です。
- Apple や Google が、すべてのスマホが常に維持している接続を通じて通知を届け、スマホに表示されます。
ステップ 3 と 4 があるおかげで、アプリが閉じていてもバッテリーを消耗させずにプッシュが機能します。スマホが自分から問い合わせることはないからです。経路の詳細は プッシュ通知の仕組み: APNs と FCM で説明しています。
Apple や Google に直接つながない理由
両方のストアに自分のアプリがあれば直接つなぐこともできます。ただし、間に何も挟まずに自分のスマホへ送るには、次のものが必要です。
- Apple Developer Program のメンバーシップと、プッシュ通知の entitlement を組み込んだ iOS アプリ。もう一方の Android 側には Firebase プロジェクトと Android アプリ。
- APNs の署名キーと Firebase のサービスアカウント、そしてそれぞれのリクエストに署名するコード。
- アプリからデバイストークンを集め、変更されたら最新の状態に保つ仕組み。
- 2 種類のリクエスト形式、2 種類の優先度モデル、2 セットのエラーコード。
アプリそのものがプロダクトなら、これは妥当なプロジェクトです。しかし「cron ジョブが失敗したら知らせて」だけのためには大がかりすぎます。プッシュ通知サービスは、これらすべてを一度だけ、全員のために用意しています。
リクエストの形
Pocket Alert で通知を送るのは、認証付きの POST 1 回だけです。
curl -X POST https://api.pocketalert.app/v1/messages \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'
レスポンスは、保存されたメッセージと送信時の優先度を含む 201 Created です。同じリクエストは HTTP クライアントを使えるどの言語からでも送れます。ターミナルでの例は curl でプッシュ通知を送る にまとめています。
必須なのは title と message だけです。アラートで特に重要なオプションフィールドは次のとおりです。
levelで通知の鳴り方を指定します。silent、low、default、high、criticalから選べます。actionsで通知に最大 3 つのボタンを追加します。URL を開く、HTTP リクエストを送る、値をコピーする、のいずれかです。send_atまたはdelayで、今ではなく後から送信します(有料プラン)。application_idとdevice_idで、どのプロジェクトに属するか、どのスマホに届けるかを指定します。
API だけではない 3 つの入口
プッシュ通知 API は、ソースごとにコードを書かなくてよいときに最も役立ちます。
- HTTP API: 自分のスクリプト、ジョブ、アプリから使います。
- Webhook URL: すでに Webhook を送信しているサービス向けです。GitHub、Stripe、Grafana、Sentry は独自の JSON を Pocket Alert の Webhook に送れます。
%repository.name%のようなプレースホルダーを使うと、その JSON から必要なフィールドを抜き出して通知に含められ、間にコードは不要です。手順は 最初の Webhook URL を作成する で説明しています。 - CLI と MCP サーバー: ターミナルや AI エージェント向けです。シェルから
pocketalert send "Build done" "All tests passed"を実行したり(CLI)、長いタスクが終わったときに Claude や Cursor が呼び出すcreate_messageツールを使ったりできます(MCP)。
どんな場面で使うか
アラートの多くは、次のいずれかに当たります。
- 何かが壊れた。 サーバーが応答しない、cron ジョブが異常終了した、バックアップが実行されなかった。cron ジョブのアラート と サーバー監視 を参照してください。
- 何かが終わった。 デプロイ、長いビルド、12 時間かかる 3D プリント、AI エージェントのタスク。デプロイのアラート を参照してください。
- 気にかけている出来事が起きた。 入金、新規登録、フォームの送信。入金のアラート と 新規登録のアラート を参照してください。
- これから何かが起きる。 14 日後に期限切れになる証明書。SSL 期限切れのアラート を参照してください。
共通点は、次回ダッシュボードや受信箱を開くときではなく、今知っておくべき出来事だということです。
選ぶ前に確認すること
この分野のサービスはどれも、HTTP リクエストからプッシュを送ります。違いは周辺の部分にあります。
- 対応プラットフォーム。 iPhone 専用のものもあります(Bark、The Notification App)。Gotify の公式アプリは Android 向けだけです。アラートを受け取る人が別の機種を使っているなら、それで決まります。
- 優先度レベル。 失敗したバックアップと新規登録で通知の音を変えられるか。重大なアラートをおやすみモードでも届けられるか。
- 受信 Webhook。 サービスが独自の JSON をそのまま送れるか、それとも送信元ごとに形を整えるスクリプトが必要か。
- 履歴とログ。 アラートが届かなかったとき、呼び出しの記録と、その後どうなったかが残っているか。
- 上限と料金。 1 日、1 か月、あるいは生涯の上限はどれくらいか。上限に達したらどうなるか。
- 運用者。 ホスト型サービスか、自分で保守するサーバーか。
Pocket Alert を Pushover、ntfy、Pushbullet、Bark、Gotify などと、まさにこれらの点で比較しています。それぞれが優れている場合も含めて、代替サービス で確認できます。
FAQ
プッシュ通知 API は Firebase Cloud Messaging と同じものですか?
FCM も 1 つのプッシュ通知 API です。Google が提供するもので、自分で作って公開するアプリ向けです。Pocket Alert のようなサービスは FCM と APNs の上に乗り、アプリ、キー、デバイストークンを管理するので、ユーザーが作るのは HTTP リクエストだけです。
モバイルアプリを開発する必要はありますか?
自分やチームへのアラートであれば不要です。iPhone または Android 向けの Pocket Alert のような既存アプリをインストールして、そこに送信します。自分のユーザーに送りたいときだけ、独自のアプリが必要になります。
無料で使えますか?
多くのサービスには無料プランがあります。Pocket Alert の無料プランは、クレジットカード不要で 1 日 50 件まで送信できます。個人のアラート用途の大半はこれで足ります。有料プランは月 6 ドルから、1 日 1,000 件までです。詳しくは 料金ページ をご覧ください。
配信までどれくらいかかりますか?
通常はリクエストからロック画面まで数秒です。ただし Apple と Google はタイミングを保証していません。電波がない、または省電力モードが厳しく設定されているスマホは、再接続したときに通知を受け取ります。
プッシュ、SMS、メールのどれを選ぶべきですか?
すぐに対応が必要なものはプッシュ、ダイジェストや記録はメール、スマホアプリがまったくない相手には SMS が向いています。それぞれの長所と短所は プッシュ通知と SMS の比較 と プッシュ通知とメールアラートの比較 にまとめています。
無料アカウントを作成 して API キーをコピーすれば、上の curl コマンドが最初のプッシュ通知になります。