API отправки почты
Отправляйте письма со своего домена на стороне сервера с теми же квотами, оплатой и ограничениями, что и в консоли. Домен отправителя должен точно совпадать с подключённым активным доменом отправки.
- Авторизация: тот же пользовательский API-ключ, что и для остальных открытых API платформы
- Отправка: POST /api/v1/mail/send; ответ сгруппирован по получателям, а bounced_addrs — единственное основание для очистки списка
- Идемпотентность: при заголовке Idempotency-Key повторные запросы с одним ключом выполняют отправку ровно один раз, без повторной доставки и оплаты
- Цепочки: передайте in_reply_to и полную цепочку references, чтобы ответы попали в исходную переписку получателя
- Квоты и домены: запрашивайте оставшуюся суточную квоту и доступные домены отправки для ограничения скорости в своей системе
- Примеры: минимальные рабочие cURL / Node.js / Python / Go / PHP, каждый с идемпотентностью и обработкой постоянных отказов
Часто задаваемые вопросы
Означает ли HTTP 200, что все получатели получили письмо?
Нет. Результаты разделены по получателям: из пяти адресатов 2 могут получить письмо, 1 — остаться в очереди, а 2 — получить постоянный отказ. Вебхука отказов нет, поэтому bounced_addrs — единственная основа очистки списка. Немедленно прекратите отправку на эти адреса.
Когда требуется Idempotency-Key?
Всегда, когда вызов может повторяться автоматически: после тайм-аута, повторной выдачи задачи из очереди или встроенного повтора SDK. Без него краткий сетевой сбой может привести к двум письмам и двойной оплате, которые нельзя отменить. Используйте бизнес-ключ, например идентификатор заказа.
Связанные страницы: Документация API Tovanix · SMTP API почты · Высокая доставляемость · Использование API агрегации SMTP
Загрузка…