Перейти к содержимому

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

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

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

ТарифСообщений в день
Бесплатный50
Starter1,000
Medium5,000
LargeБез ограничений

Текущий тариф и использование за сегодня доступны на странице Оплата, а также через API: GET /v1/messages/usage.

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

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

  • Запросы к API — POST /v1/messages, включая запросы с вложением.
  • Вызовы вебхуков — каждый вызов, который создаёт сообщение.
  • Отложенные сообщения — учитываются в день, когда вы их запланировали, а не в день доставки. Сообщение, запланированное сегодня на следующий вторник, расходует сегодняшний лимит. Сама доставка лимит не расходует и им не блокируется.

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

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

Удаление сообщений не возвращает лимит

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

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

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

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, но каждый такой вызов всё равно записывается в историю вебхука вместе с полным payload и сообщением, которое он бы создал. У записи status: "error" и error_code: "daily_limit", поэтому ничего не пропадает бесследно: откройте историю, чтобы увидеть, что пришло, пока лимит был превышен.

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

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

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

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

Письма ​

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

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

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

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

Новый тариф применяется сразу: после оплаты апгрейда следующий запрос проверяется по новому лимиту, ждать сброса не нужно. См. тарифы.

Связанное ​

Документация Pocket Alert