Дневные лимиты сообщений
Каждый тариф включает определённое количество сообщений в день. Счётчик обнуляется в 00:00 UTC. Как только вы достигаете лимита, новые сообщения отклоняются с ответом 429 Too Many Requests до сброса счётчика: они не сохраняются и push-уведомление не отправляется.
Лимиты по тарифам
| Тариф | Сообщений в день |
|---|---|
| Бесплатный | 50 |
| Starter | 1,000 |
| Medium | 5,000 |
| Large | Без ограничений |
Текущий тариф и использование за сегодня доступны на странице Оплата, а также через API: GET /v1/messages/usage.
Что учитывается
Каждое сообщение, созданное в вашем аккаунте, учитывается один раз в тот UTC-день, когда оно было создано:
- Запросы к API —
POST /v1/messages, включая запросы с вложением. - Вызовы вебхуков — каждый вызов, который создаёт сообщение.
- Отложенные сообщения — учитываются в день, когда вы их запланировали, а не в день доставки. Сообщение, запланированное сегодня на следующий вторник, расходует сегодняшний лимит. Сама доставка лимит не расходует и им не блокируется.
Что не учитывается:
- Запросы, которые не прошли валидацию (
400,403) или завершились ошибкой на нашей стороне (500), — лимит возвращается. - Сами отклонённые запросы. Они учитываются отдельно как
rejected, чтобы вы видели, что было пропущено.
Удаление сообщений не возвращает лимит
Счётчик учитывает отправленные сообщения, а не сохранённые. Удаление сообщений по одному или все сразу не возвращает сегодняшний лимит.
Когда лимит достигнут
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 может ждать до полуночи
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" ...Вебхуки
Вызовы вебхуков сверх лимита отклоняются тем же 429, но каждый такой вызов всё равно записывается в историю вебхука вместе с полным 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% дневного лимита — предупреждение, пока ещё есть запас.
- При первом отклонённом сообщении — лимит исчерпан, новые сообщения не принимаются.
Тарифы без ограничений такие письма не получают.
Повышение тарифа
Новый тариф применяется сразу: после оплаты апгрейда следующий запрос проверяется по новому лимиту, ждать сброса не нужно. См. тарифы.
Связанное
- Создание сообщения — ответ
429в контексте - Использование сообщений — использование за сегодня через API
- История вебхука — где хранятся отклонённые вызовы вебхуков
- Отложенная отправка — как учитываются отложенные сообщения