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

> プッシュ通知 API は、1 回の HTTP リクエストをスマホへの通知に変換します。その仕組み、同じ名前で呼ばれる 2 種類のサービス、リクエストの形、選ぶ前に確認すべき点を説明します。

*04.10.2026*

<!-- source: https://pocketalert.app/ja/blog/what-is-a-push-notification-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](/blog/how-push-notifications-work-apns-fcm) で説明しています。

## Apple や Google に直接つながない理由

両方のストアに自分のアプリがあれば直接つなぐこともできます。ただし、間に何も挟まずに自分のスマホへ送るには、次のものが必要です。

- Apple Developer Program のメンバーシップと、プッシュ通知の entitlement を組み込んだ iOS アプリ。もう一方の Android 側には Firebase プロジェクトと Android アプリ。
- APNs の署名キーと Firebase のサービスアカウント、そしてそれぞれのリクエストに署名するコード。
- アプリからデバイストークンを集め、変更されたら最新の状態に保つ仕組み。
- 2 種類のリクエスト形式、2 種類の優先度モデル、2 セットのエラーコード。

アプリそのものがプロダクトなら、これは妥当なプロジェクトです。しかし「cron ジョブが失敗したら知らせて」だけのためには大がかりすぎます。プッシュ通知サービスは、これらすべてを一度だけ、全員のために用意しています。

## リクエストの形

Pocket Alert で通知を送るのは、認証付きの POST 1 回だけです。

```bash
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 でプッシュ通知を送る](/use-cases/curl-push-notifications) にまとめています。

必須なのは `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 を作成する](/blog/create-your-first-webhook-url) で説明しています。
- **CLI と MCP サーバー**: ターミナルや AI エージェント向けです。シェルから `pocketalert send "Build done" "All tests passed"` を実行したり（[CLI](/tools/cli)）、長いタスクが終わったときに Claude や Cursor が呼び出す `create_message` ツールを使ったりできます（[MCP](/tools/mcp)）。

## どんな場面で使うか

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

- **何かが壊れた。** サーバーが応答しない、cron ジョブが異常終了した、バックアップが実行されなかった。[cron ジョブのアラート](/use-cases/cron-job-alerts) と [サーバー監視](/use-cases/server-monitoring) を参照してください。
- **何かが終わった。** デプロイ、長いビルド、12 時間かかる 3D プリント、AI エージェントのタスク。[デプロイのアラート](/use-cases/deployment-alerts) を参照してください。
- **気にかけている出来事が起きた。** 入金、新規登録、フォームの送信。[入金のアラート](/use-cases/payment-alerts) と [新規登録のアラート](/use-cases/signup-alerts) を参照してください。
- **これから何かが起きる。** 14 日後に期限切れになる証明書。[SSL 期限切れのアラート](/use-cases/ssl-expiration-alerts) を参照してください。

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

## 選ぶ前に確認すること

この分野のサービスはどれも、HTTP リクエストからプッシュを送ります。違いは周辺の部分にあります。

- **対応プラットフォーム。** iPhone 専用のものもあります（Bark、The Notification App）。Gotify の公式アプリは Android 向けだけです。アラートを受け取る人が別の機種を使っているなら、それで決まります。
- **優先度レベル。** 失敗したバックアップと新規登録で通知の音を変えられるか。重大なアラートをおやすみモードでも届けられるか。
- **受信 Webhook。** サービスが独自の JSON をそのまま送れるか、それとも送信元ごとに形を整えるスクリプトが必要か。
- **履歴とログ。** アラートが届かなかったとき、呼び出しの記録と、その後どうなったかが残っているか。
- **上限と料金。** 1 日、1 か月、あるいは生涯の上限はどれくらいか。上限に達したらどうなるか。
- **運用者。** ホスト型サービスか、自分で保守するサーバーか。

Pocket Alert を Pushover、ntfy、Pushbullet、Bark、Gotify などと、まさにこれらの点で比較しています。それぞれが優れている場合も含めて、[代替サービス](/alternatives) で確認できます。

## FAQ

### プッシュ通知 API は Firebase Cloud Messaging と同じものですか？

FCM も 1 つのプッシュ通知 API です。Google が提供するもので、自分で作って公開するアプリ向けです。Pocket Alert のようなサービスは FCM と APNs の上に乗り、アプリ、キー、デバイストークンを管理するので、ユーザーが作るのは HTTP リクエストだけです。

### モバイルアプリを開発する必要はありますか？

自分やチームへのアラートであれば不要です。[iPhone または Android](/get-app) 向けの Pocket Alert のような既存アプリをインストールして、そこに送信します。自分のユーザーに送りたいときだけ、独自のアプリが必要になります。

### 無料で使えますか？

多くのサービスには無料プランがあります。Pocket Alert の無料プランは、クレジットカード不要で 1 日 50 件まで送信できます。個人のアラート用途の大半はこれで足ります。有料プランは月 6 ドルから、1 日 1,000 件までです。詳しくは [料金ページ](/pricing) をご覧ください。

### 配信までどれくらいかかりますか？

通常はリクエストからロック画面まで数秒です。ただし Apple と Google はタイミングを保証していません。電波がない、または省電力モードが厳しく設定されているスマホは、再接続したときに通知を受け取ります。

### プッシュ、SMS、メールのどれを選ぶべきですか？

すぐに対応が必要なものはプッシュ、ダイジェストや記録はメール、スマホアプリがまったくない相手には SMS が向いています。それぞれの長所と短所は [プッシュ通知と SMS の比較](/blog/push-notifications-vs-sms) と [プッシュ通知とメールアラートの比較](/blog/push-vs-email-alerts) にまとめています。

[無料アカウントを作成](/signup) して API キーをコピーすれば、上の curl コマンドが最初のプッシュ通知になります。
