Перейти к документации
API

Ещё не сделано

Перечислено, а не умолчано.

Чего не хватает

Ещё не выпущено

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

  • Доставка пробуется до пяти раз: сразу, затем через 1 минуту, 5, 25 и 2 часа. Каждая попытка записывается и доступна через GET /webhooks/{id}/deliveries, и в каждой есть attempt и maxAttempts. Повторы прекращаются раньше, когда ответ говорит, что повторять бессмысленно: всё, кроме 408, 425, 429 или 5xx, считается намеренным отказом. Эндпоинта для повторного проигрывания по-прежнему нет, так что у эндпоинта, недоступного дольше этого окна, будет пробел, и искать его нужно в журнале доставок.
  • Отбитое сообщение по-прежнему числится как sent в GET /emails: отчёт о доставке сопоставляется с оригиналом и помечается на цепочке, но в строку отправки ничего не записывается обратно, а у её статуса нет состояния «отбито». Подавление, которое из этого следует, работает по-настоящему: жёсткий отбой или жалоба помещают адрес в список подавления этого рабочего пространства, и следующая отправка на него отклоняется. Не учится именно запись об отправке.
  • Общего ограничителя частоты запросов нет. Существуют два подсчитываемых потолка, и оба отвечают 429: рабочее пространство, израсходовавшее месячную квоту отправки своего тарифа, получает send_quota_exceeded на каждую следующую отправку до первого числа месяца, а выпуск одноразовых ящиков ограничен шестью в час и тридцатью в день на клиента с too_many_inboxes. Ни один из них не отдаёт Retry-After. Ограничитель частоты обычных чтений и записей — это отсутствие, а не обещание, и его собираются исправить.
  • В API нет эндпоинта ЗАГРУЗКИ вложений. Встроенные вложения передаются в base64 и ограничены 5 МБ на всё сообщение. Файл побольше отправляется как { fileId }, указывающий на файл, уже находящийся в рабочем пространстве, и уходит ссылкой на скачивание. Чтение вложений из полученной почты работает.