1 日のメッセージ上限
すべてのプランには 1 日あたりのメッセージ数の上限があります。カウントは 毎日 00:00 UTC にリセットされます。上限に達すると、リセットまで新しいメッセージは 429 Too Many Requests で拒否されます。これらのメッセージは保存されず、プッシュ通知も送信されません。
プラン別の上限
| プラン | 1 日あたりのメッセージ数 |
|---|---|
| 無料プラン | 50 |
| Starter | 1,000 |
| Medium | 5,000 |
| Large | 無制限 |
現在のプランと本日の使用状況は お支払い ページで確認できます。また、GET /v1/messages/usage を使って API からも取得できます。
カウントの対象
アカウントで作成されたすべてのメッセージは、作成された UTC の日付に 1 回ずつカウントされます。
- API リクエスト —
POST /v1/messages。添付ファイルを含むリクエストも対象です。 - Webhook の呼び出し — メッセージを生成した呼び出しごと。
- 予約メッセージ — 配信日ではなく、予約した日にカウントされます。今日、来週の火曜日向けにスケジュールしたメッセージは、今日の枠を使用します。配信自体は枠を消費せず、枠によってブロックされることもありません。
カウントされないもの:
- バリデーションに失敗したリクエスト(
400、403)や、当社側で失敗したリクエスト(500)。これらは枠が返却されます。 - 拒否されたリクエストそのもの。これらは
rejectedとして別途集計され、取りこぼしたメッセージを確認できます。
メッセージを削除しても枠は戻りません
カウンターが追跡するのは送信されたメッセージ数であり、保存されているメッセージ数ではありません。メッセージを 1 件ずつ削除しても、まとめて削除しても、本日の枠は戻りません。
上限に達したとき
API は 429 Too Many Requests を返します。Retry-After ヘッダーには、リセットまでの秒数が入ります。
HTTP/1.1 429 Too Many Requests
Retry-After: 30142
X-PA-Daily-Limit: 50
X-PA-Daily-Remaining: 0
X-PA-Daily-Reset: 1790035200{
"error": "Daily message limit reached (50/50). New messages are rejected until 00:00 UTC. Upgrade your plan to raise the limit.",
"limit": 50,
"used": 50,
"resets_at": "2026-09-22T00:00:00Z",
"upgrade_url": "https://pocketalert.app/pricing"
}連携先での 429 の扱い
429 は一時的な障害ではなく、「今は送れない」という意味として扱ってください。Retry-After の時間が経過する前に再試行しても同じ結果になり、再試行のたびに拒否されてカウントされます。resets_at まで待つか、そのアラートを破棄してログに記録してください。
curl --retry は深夜 0 時まで待機し続けることがあります
curl --retry は 429 を再試行可能とみなし、Retry-After に従います。そのため、上限超過時にリトライするスクリプトは 00:00 UTC まで待機してしまいます。--retry-max-time で待機時間の上限を設定してください。
curl --retry 3 --retry-max-time 60 -X POST "https://api.pocketalert.app/v1/messages" ...Webhook
上限を超えた Webhook の呼び出しは、同じ 429 で拒否されます。ただし、各呼び出しは Webhook の 履歴 に、ペイロード全体と、本来生成されるはずだったメッセージとともに記録されます。該当エントリーには status: "error" と error_code: "daily_limit" が設定されるため、上限超過中に届いたものが痕跡なく消えることはありません。履歴を開くと、上限を超えている間に届いた内容を確認できます。
レート制限ヘッダー
成功した POST /v1/messages(およびメッセージを作成したすべての Webhook 呼び出し)には、現在の枠の情報が含まれます。
| ヘッダー | 意味 |
|---|---|
X-PA-Daily-Limit | プランで 1 日に送信できるメッセージ数 |
X-PA-Daily-Remaining | 今回のメッセージを含めた後の、本日の残り数 |
X-PA-Daily-Reset | 次回リセット(00:00 UTC)の Unix タイムスタンプ(秒) |
無制限プランには、これらのヘッダーは付与されません。
メール通知
Pocket Alert がアカウント所有者へメールを送信するのは、1 日あたり最大 2 回までです。
- 1 日の上限の 80% に達したとき — まだ余裕があるうちに知らせるお知らせです。
- 最初のメッセージが拒否されたとき — 上限に達し、新しいメッセージが拒否され始めたことをお知らせします。
無制限プランには、これらのメールは送信されません。
アップグレード
新しいプランはすぐに適用されます。アップグレードが完了すると、次のリクエストから新しい上限で判定されます。リセットを待つ必要はありません。詳しくは 料金 をご覧ください。
関連情報
- メッセージを作成 — 文脈の中での
429レスポンス - メッセージの使用状況 — API で確認できる本日の使用状況
- Webhook 履歴 — 拒否された Webhook 呼び出しの保管場所
- 予約送信 — 予約メッセージのカウント方法