ブログに戻る

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

プッシュ通知 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 つのステップがあります。

  1. コードが、タイトル、メッセージ、API キーを含む HTTPS リクエストをサービスに送ります。
  2. サービスが API キーを確認し、メッセージを保存して、送り先を決めます。どのデバイスに、どの優先度で送るかです。
  3. サービスが通知をプラットフォームのプッシュネットワークに渡します。iPhone では APNs、Android では Firebase Cloud Messaging です。
  4. 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)。

どんな場面で使うか

アラートの多くは、次のいずれかに当たります。

共通点は、次回ダッシュボードや受信箱を開くときではなく、今知っておくべき出来事だということです。

選ぶ前に確認すること

この分野のサービスはどれも、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 コマンドが最初のプッシュ通知になります。

この記事をシェア