Маршрутизация почты

API для управления правилами маршрутизации исходящей почты в организации.

Назначение правил

Правила маршрутизации позволяют администратору организации настраивать отправку исходящих писем:

  1. Принудительно отправлять письма на указанный адрес почтового сервера для заданных доменов.

  2. Выбирать маршрут отправки для заданных доменов в зависимости от типа получателя:

    • на указанный адрес почтового сервера;
    • Яндекс-получателям (определяется по UID в blackbox).
  3. Принудительно отправлять все исходящие письма организации на указанный адрес почтового сервера.

  4. Принудительно отправлять письма внешним получателям на указанный адрес почтового сервера.

В одном правиле можно указать только один адрес почтового сервера.

Ограничения и приоритеты

  • Для организации допустимо только одно правило, охватывающее все исходящие письма. Чтобы создать или удалить такое правило, укажите в качестве домена получателя пустую строку ("").

  • Правила с указанным доменом имеют приоритет над правилом с пустым доменом.

  • Приоритет работает следующим образом:

    • если домен получателя совпадает с доменом в правиле — письмо отправляется по этому правилу;
    • если совпадений нет — применяется правило с пустым доменом ("").

Обработка доменов

Все операции с правилами выполняются на основе IDN-представления доменов.

Следующие варианты записи считаются идентичными:

  • домен0.орг
  • ДОМЕН0.ОРГ
  • xn--0-gtbd1agd.xn--c1avg

Разрешения

Разрешения на использование сервиса, которые доступны при настройке приложения:

  • ya360_admin:mail_read_domain_routes — для просмотра правил маршрутизации;
  • ya360_admin:mail_write_domain_routes — для создания, обновления и удаления правил.

Endpoints