SMTP

Доступные сервера

Сервис доступен по следующим адресам:

• TCP – smtp.mail-king.ru:25, без шифрования, но с поддержкой расширения STARTTLS.

• TLS – smtp.mail-king.ru:587, с шифрованием.

Идемпотентность

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

Чтобы начать пользоваться механизмом, достаточно добавить в письмо новый заголовок - Idempotence-Key. По-умолчанию, сервер хранит информацию об указанном ключе на протяжении 60 секунд с момента его получения.

Если для вашей системы этого недостаточно, вы можете увеличить данный показатель с помощью заголовка Idempotence-Ttl. Время жизни ключа задается в миллисекундах и имеет ограничения. Значение не может быть меньше 1 000 (1 секунда) и больше 3 600 000 (1 час).

Успешная отправка

Subject: Тема письма
Idempotence-Key: b45c14e8714c404594b13087d8699525
Idempotence-Ttl: 600000

Содержимое письма.
.
250 2.0.0 OK: queued

Повторная отправка

Subject: Тема письма
Idempotence-Key: b45c14e8714c404594b13087d8699525

Содержимое письма.
.
409 4.0.9 Mail with same idempotence key already in process.