Лимиты

Кратко

• 1/сек

  Запросы к API на адрес

  Опрос раз в секунду — предусмотренный режим работы.

• 5дней

  Срок хранения сообщений

  С момента получения, прочитано или нет. Жёсткий лимит.

• 5MB

  Максимальный размер сообщения

  Отклоняется на этапе SMTP, поэтому отправитель об этом узнаёт.

• ∞

  Адресов на домен

  Заранее ничего не создаётся, поэтому и считать нечего.

• 200

  Сообщений за один запрос

  По умолчанию 50. Это ограничивает один ответ, а не сам ящик: next листает всё остальное, сколько бы его ни было.

• 0

  Исходящие сообщения

  Эндпоинта для отправки нет. Так и задумано.

Лимит запросов

Один запрос в секунду на адрес. Лимит действует на почтовый ящик, а не на IP-адрес, поэтому общий CI-раннер, опрашивающий двадцать разных ящиков, не конкурирует сам с собой.

При превышении лимита вы получите 429 с заголовком Retry-After в целых секундах. Нет ни суточной квоты, ни месячной, ни запаса на всплеск нагрузки.

Есть и второй предел, и он указан здесь, а не оставлен на самостоятельное обнаружение: 1200 запросов в минуту с одного исходного адреса. Это ровно тот же пример с двадцатью почтовыми ящиками в секунду, приведённый выше, поэтому обычная автоматизация никогда его не достигает — он существует, чтобы один хост не мог перебрать десять тысяч адресов в секунду.

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{
  "error":   "rate_limited",
  "message": "one request per second, per address"
}

Ориентируйтесь на Retry-After, а не на фиксированную паузу. Если лимит когда-нибудь изменится, код, читающий этот заголовок, продолжит работать.

Размер сообщения

Сообщения размером до 5 MB, включая вложения. Это ограничение применяется почтовым сервером во время SMTP-сессии, и это важно: отправляющий сервер узнаёт об этом в момент попытки и сообщает своему пользователю о реальной ошибке — вместо того чтобы сообщение просто исчезло.

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

Всё закодированное сообщение целиком — заголовки, тело и все вложения после MIME-кодирования. Base64 увеличивает бинарные данные примерно на треть, поэтому файл около 3,5 МБ уже заполняет собой весь предел.

Что происходит на линии

Код 552 во время сеанса SMTP. Сообщение никогда не сохраняется и никогда не появляется в почтовом ящике.

Вложений на сообщение

Двадцать. На практике предел размера наступает раньше — но если сообщение несёт больше двадцати частей с именами файлов, сохраняются только первые двадцать.

Срок хранения

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

У каждого сообщения есть expires_at, так что клиенту никогда не нужно вычислять эту дату или отслеживать политику.

Это жёсткий лимит, а не настройка: ни параметр, ни тариф, ни аккаунт его не продлевают. Если что-то должно пережить это окно, получите это и сохраните у себя.

Адреса и домены

Адресов на домен

Без ограничений и без подсчёта. Поскольку почтовый ящик никогда не создаётся, нет и списка, который мог бы расти.

Правила локальной части

От одного до 64 символов: буквы, цифры, точка, дефис, подчёркивание и плюс. Должен начинаться и заканчиваться буквой или цифрой. Всё остальное отклоняется ещё до почтового сервера — и в браузере, и повторно на сервере.

Плюс-адресация

name+tag@domain здесь отдельный почтовый ящик, а не псевдоним name@domain. Это сделано намеренно — тегами люди разделяют регистрации, и объединение адресов слило бы ящики, которые должны были оставаться раздельными.

Регистр

Всё приводится к нижнему регистру. Name@ и name@ — один и тот же ящик.

Собственные домены

Нет ограничений на число доменов, которые вы сюда направите. Каждому нужна своя MX-запись.

Квоты премиум-пула

Всё сказанное выше описывает бесплатный сервис, и он таким и остаётся: у публичных доменов и ваших собственных нет ни квоты на письма, ни лимита адресов ни на одном тарифе.

Платный тариф добавляет 92 частных домена .com, которые держат вне чёрных списков одноразовой почты. В квоту засчитываются только письма, приходящие именно на ЭТИ домены: Premium USD 24/month (2 000 premium messages/month, 1 API key, 2 req/s); Pro USD 78/month (15 000 premium messages/month, 5 API keys, 3 req/s); Scale USD 148/month (36 000 premium messages/month, 20 API keys, 5 req/s).

Они читаются через те же эндпоинты, с ключом Authorization: Bearer. Без него премиум-адрес отвечает 402 или 403 — но не ящиком.

Добросовестное использование

Нет квоты, которую можно купить, и нет тарифа, повышающего эти цифры. Вместо этого есть другое: если один источник ухудшает сервис для всех остальных, его останавливают.

Массовый опрос

Тысячи почтовых ящиков, опрашиваемых каждую секунду с одного источника, будут ограничены на краю сети ещё до того, как запрос дойдёт до API.

Почтовые потоки

Отправляющий хост, открывающий неоправданно много SMTP-соединений, блокируется на десять минут. Обычные отправители никогда не приближаются к этому пределу.

Использование нас в качестве ретранслятора

Невозможно, а не запрещено: почтовый сервер принимает только сообщения, адресованные размещённым здесь доменам, поэтому он не может ничего никуда пересылать.

Всё это не рассчитано на обычную автоматизацию как исключение. Опрашивать раз в секунду, весь день, по тысячам почтовых ящиков — это и есть предполагаемое использование, а не его крайний случай.