# Дневные лимиты сообщений

Каждый тариф включает определённое количество сообщений в день. Счётчик обнуляется в **00:00 UTC**. Как только вы достигаете лимита, новые сообщения отклоняются с ответом `429 Too Many Requests` до сброса счётчика: они не сохраняются и push-уведомление не отправляется.

## Лимиты по тарифам

| Тариф | Сообщений в день |
|-------|-----------------:|
| Бесплатный | 50 |
| Starter | 1,000 |
| Medium | 5,000 |
| Large | Без ограничений |

Текущий тариф и использование за сегодня доступны на странице [Оплата](https://pocketalert.app/account/billing), а также через API: [`GET /v1/messages/usage`](https://info.pocketalert.app/api/messages/usage.md).

## Что учитывается

Каждое сообщение, созданное в вашем аккаунте, учитывается один раз в тот UTC-день, когда оно было создано:

- **Запросы к API** — [`POST /v1/messages`](https://info.pocketalert.app/api/messages/create.md), включая запросы с вложением.
- **Вызовы вебхуков** — каждый вызов, который создаёт сообщение.
- **Отложенные сообщения** — учитываются в день, когда вы их **запланировали**, а не в день доставки. Сообщение, запланированное сегодня на следующий вторник, расходует сегодняшний лимит. Сама доставка лимит не расходует и им не блокируется.

Что не учитывается:

- Запросы, которые не прошли валидацию (`400`, `403`) или завершились ошибкой на нашей стороне (`500`), — лимит возвращается.
- Сами отклонённые запросы. Они учитываются отдельно как `rejected`, чтобы вы видели, что было пропущено.

> **Warning: Удаление сообщений не возвращает лимит**
>
> Счётчик учитывает отправленные сообщения, а не сохранённые. Удаление сообщений по одному или все сразу не возвращает сегодняшний лимит.

## Когда лимит достигнут

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` может ждать до полуночи**
>
> `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" ...
> ```

### Вебхуки

Вызовы вебхуков сверх лимита отклоняются тем же `429`, но каждый такой вызов всё равно записывается в [историю](https://info.pocketalert.app/api/webhooks/history.md) вебхука вместе с полным payload и сообщением, которое он бы создал. У записи `status: "error"` и `error_code: "daily_limit"`, поэтому ничего не пропадает бесследно: откройте историю, чтобы увидеть, что пришло, пока лимит был превышен.

## Заголовки лимитов

Каждый успешный `POST /v1/messages` (и каждый вызов вебхука, создающий сообщение) содержит текущее состояние квоты:

| Заголовок | Значение |
|-----------|----------|
| `X-PA-Daily-Limit` | Количество сообщений в день на вашем тарифе |
| `X-PA-Daily-Remaining` | Сколько сообщений осталось на сегодня, с учётом текущего |
| `X-PA-Daily-Reset` | Unix-время (в секундах) следующего сброса, 00:00 UTC |

На тарифах без ограничений эти заголовки не передаются.

## Письма

Pocket Alert отправляет владельцу аккаунта не более двух писем в день:

- **При достижении 80%** дневного лимита — предупреждение, пока ещё есть запас.
- **При первом отклонённом сообщении** — лимит исчерпан, новые сообщения не принимаются.

Тарифы без ограничений такие письма не получают.

## Повышение тарифа

Новый тариф применяется сразу: после оплаты апгрейда следующий запрос проверяется по новому лимиту, ждать сброса не нужно. См. [тарифы](https://pocketalert.app/pricing).

## Связанное

- [Создание сообщения](https://info.pocketalert.app/api/messages/create.md) — ответ `429` в контексте
- [Использование сообщений](https://info.pocketalert.app/api/messages/usage.md) — использование за сегодня через API
- [История вебхука](https://info.pocketalert.app/api/webhooks/history.md) — где хранятся отклонённые вызовы вебхуков
- [Отложенная отправка](https://info.pocketalert.app/features/scheduled-delivery.md) — как учитываются отложенные сообщения
