Бесплатный тариф
1 домен, 1 ящик, 1 ГБ почты и 100 исходящих получателей в календарный месяц. Общий лимит учитывает кабинет и все API-ключи. Каждый адресат считается отдельно. Сброс первого числа в 00:00 по Москве.
Отправка резервирует месячный лимит. Достоверный отказ или отмена до передачи освобождает соответствующий резерв; неизвестный результат остаётся учтённым. Идемпотентный повтор не расходует его повторно. У существующих индивидуальных аккаунтов могут быть другие ограничения, актуальные значения показаны в кабинете.
Чтение
| Операция | Ограничение |
|---|---|
| Запросы чтения | 60 в минуту на ключ, 120 в минуту на организацию. |
| Получение тела | 10 в минуту на ключ и 20 в минуту на организацию, в дополнение к общему пределу. |
| Скачивания | 2 одновременных скачивания на ящик. До 64 МиБ на файл или raw. Бюджет скачиваний 256 МиБ в час на организацию по размерам запросов. |
| Текстовая часть | До 256 КиБ на часть, усечение отмечается в ответе. |
| Страница писем | По умолчанию 50, максимум 100. |
| Курсор списка | 15 минут. При изменении выборки может потребоваться новый обход. |
Чтение и вебхуки не расходуют исходящие 100 получателей. Создание новых ключей не обходит общий лимит организации.
Ограничения отправки
Почтовый ящик дополнительно ограничен 30 исходящими в час вместе с кабинетом. На ключ задаются меньшие часовой и суточный пределы. Начальные максимумы: 30 в час и 300 за 24 часа; для бесплатного аккаунта суточная настройка не выше 100, при этом месячный общий предел остаётся 100.
Для всех интеграций организации также действуют защитные пределы 60 отправок в час и 600 за 24 часа. Окна защитных счётчиков начинаются с первого запроса, а не в полночь. Отдельный месячный счётчик тарифа следует московскому календарю.
До 10 активных API-ключей и 100 незавершённых API-писем в очереди. На ключ отправки также действует до 120 HTTP-запросов в минуту, включая опрос квитанции. Выбирайте разумный интервал опроса.
Подключения и вебхуки
- 5 активных паролей приложений на ящик.
- 2 вебхука на ящик.
- Повторы доставки до 24 часов.
- Журнал вебхуков и отправки: 30 дней.
- Метаданные событий: 7 дней, сбор при активных вебхуках.
Формат ошибки
{
"error": {
"code": "monthly_send_limit",
"message": "Достигнут месячный лимит отправки",
"requestId": "REQUEST_ID"
}
}- 400
- Проверьте параметры и JSON. Повтор без исправления не поможет.
- 401
- Проверьте Bearer-ключ и его отзыв.
- 403
- Проверьте права. Не вызывайте серверный API из браузера с Origin.
- 404
- Объект недоступен ключу или уже удалён.
- 409
- cursor_stale: начать чтение заново. idempotency_conflict: другой запрос с прежним ключом повтора.
- 410
- Истекла позиция истории событий. Сверьте текущее состояние ящика.
- 429
- Исчерпан лимит или превышена частота. Учитывайте Retry-After, если он возвращён.
- 503
- Сервис или операция временно недоступны. Используйте ограниченные повторы с задержкой.
Повторяйте безопасно
Для чтения используйте задержку с увеличением и случайным разбросом. Для отправки сохраняйте тот же Idempotency-Key и тело запроса. Не превращайте unknown в новую отправку автоматически.
При обращении в support@plima.ru передайте время, endpoint, HTTP-код и requestId. Не присылайте API-ключи, пароли, коды входа или содержимое почты.