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 }, указывающий на файл, уже находящийся в рабочем пространстве, и уходит ссылкой на скачивание. Чтение вложений из полученной почты работает.