# 1 日のメッセージ上限

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

## プラン別の上限

| プラン | 1 日あたりのメッセージ数 |
|------|-----------------:|
| 無料プラン | 50 |
| Starter | 1,000 |
| Medium | 5,000 |
| Large | 無制限 |

現在のプランと本日の使用状況は [お支払い](https://pocketalert.app/account/billing) ページで確認できます。また、[`GET /v1/messages/usage`](https://info.pocketalert.app/api/messages/usage.md) を使って API からも取得できます。

## カウントの対象

アカウントで作成されたすべてのメッセージは、作成された UTC の日付に 1 回ずつカウントされます。

- **API リクエスト** — [`POST /v1/messages`](https://info.pocketalert.app/api/messages/create.md)。添付ファイルを含むリクエストも対象です。
- **Webhook の呼び出し** — メッセージを生成した呼び出しごと。
- **予約メッセージ** — 配信日ではなく、**予約した日**にカウントされます。今日、来週の火曜日向けにスケジュールしたメッセージは、今日の枠を使用します。配信自体は枠を消費せず、枠によってブロックされることもありません。

カウントされないもの:

- バリデーションに失敗したリクエスト（`400`、`403`）や、当社側で失敗したリクエスト（`500`）。これらは枠が返却されます。
- 拒否されたリクエストそのもの。これらは `rejected` として別途集計され、取りこぼしたメッセージを確認できます。

> **Warning: メッセージを削除しても枠は戻りません**
>
> カウンターが追跡するのは送信されたメッセージ数であり、保存されているメッセージ数ではありません。メッセージを 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"
}
```

> **Tip: 連携先での 429 の扱い**
>
> `429` は一時的な障害ではなく、「今は送れない」という意味として扱ってください。`Retry-After` の時間が経過する前に再試行しても同じ結果になり、再試行のたびに拒否されてカウントされます。`resets_at` まで待つか、そのアラートを破棄してログに記録してください。

> **Warning: `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 の [履歴](https://info.pocketalert.app/api/webhooks/history.md) に、ペイロード全体と、本来生成されるはずだったメッセージとともに記録されます。該当エントリーには `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% に達したとき** — まだ余裕があるうちに知らせるお知らせです。
- **最初のメッセージが拒否されたとき** — 上限に達し、新しいメッセージが拒否され始めたことをお知らせします。

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

## アップグレード

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

## 関連情報

- [メッセージを作成](https://info.pocketalert.app/api/messages/create.md) — 文脈の中での `429` レスポンス
- [メッセージの使用状況](https://info.pocketalert.app/api/messages/usage.md) — API で確認できる本日の使用状況
- [Webhook 履歴](https://info.pocketalert.app/api/webhooks/history.md) — 拒否された Webhook 呼び出しの保管場所
- [予約送信](https://info.pocketalert.app/features/scheduled-delivery.md) — 予約メッセージのカウント方法
