コンテンツへスキップ

1 日のメッセージ上限 ​

すべてのプランには 1 日あたりのメッセージ数の上限があります。カウントは 毎日 00:00 UTC にリセットされます。上限に達すると、リセットまで新しいメッセージは 429 Too Many Requests で拒否されます。これらのメッセージは保存されず、プッシュ通知も送信されません。

プラン別の上限 ​

プラン1 日あたりのメッセージ数
無料プラン50
Starter1,000
Medium5,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
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
json
{
  "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 で待機時間の上限を設定してください。

bash
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% に達したとき — まだ余裕があるうちに知らせるお知らせです。
  • 最初のメッセージが拒否されたとき — 上限に達し、新しいメッセージが拒否され始めたことをお知らせします。

無制限プランには、これらのメールは送信されません。

アップグレード ​

新しいプランはすぐに適用されます。アップグレードが完了すると、次のリクエストから新しい上限で判定されます。リセットを待つ必要はありません。詳しくは 料金 をご覧ください。

関連情報 ​

Pocket Alert ドキュメント