Отправка и операции
Поставить письмо в очередь
Получите ID ящика из GET /v1/mailboxes. Создайте уникальный Idempotency-Key для одной отправки и сохраните его до окончательного результата. При сетевом повторе используйте тот же ключ и то же тело.
HTTP 202 возвращает объект операции, а не подтверждение доставки. Поле id содержит ID операции. Опросите GET /v1/operations/{operation_id}.
POST /v1/mailboxes/42/sendIdempotency-Key: message-20261019-0001Content-Type: application/json
{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}Как понимать результат
queued- Письмо ожидает отправки.
running- Отправка выполняется.
succeeded- Почтовый сервер принял отправку. Проверьте результат для каждого получателя.
failed- Отправка завершилась ошибкой. Причина указана в error.
cancelled- Отправка отменена.
uncertain- Не удалось подтвердить результат отправки. Проверьте операцию и папку отправленных перед новой попыткой.
После успешной отправки поле result содержит accepted_recipients — принятых получателей, rejected_recipients — отклонённых получателей и sent_saved — результат сохранения копии в отправленных. Принятие письма почтовым сервером не гарантирует доставку во входящие получателя.
Для отмены ожидающей отправки выполните POST /v1/operations/{operation_id}/cancel. Метод /retry не отправляет письма повторно.
Ответ, пересылка и отложенная отправка
Для ответа укажите message_id исходного письма в reply_to_message_id и передайте его references. В to укажите адрес для ответа из reply_to или адрес отправителя. Для ответа всем добавьте остальных участников в to и cc, исключив собственный адрес.
Для пересылки вложений передайте forward_message с folder, uidvalidity и uid. Для своих загруженных файлов используйте file_ids. Общий размер вложений ограничен 25 МиБ.
send_at задаётся с часовым поясом, хранится в UTC; отложенная отправка доступна в пределах года. Лимиты проверяются при фактической отправке, а не при создании очереди.