Как работать с DashaMail API: авторизация, отправка писем и где документация?

Question

Добрый день. Планируем интегрировать наш сервис с DashaMail — нужна отправка транзакционных писем и синхронизация контактов через API. Подскажите, как у DashaMail устроен API: как авторизоваться, какой метод использовать для отправки письма, есть ли отличия HTTP API от SMTP и где лежит актуальная документация?

Answer 1

DashaMail предоставляет два основных способа интеграции: HTTP API и SMTP. Для программной отправки и работы с контактами обычно используют HTTP API.

1. Получение доступа к API

• Войдите в личный кабинет DashaMail.
• Перейдите в раздел Аккаунт → Интеграции (или аналогичный).
• Создайте или скопируйте API-ключ — он передаётся в запросах для авторизации (часто в параметре запроса или в заголовке, точный способ указан в документации).

2. Документация

Актуальная техническая документация DashaMail:

• HTTP API: docs.dashamail.ru
• Транзакционные письма: dashamail.ru/transactional
• SMTP: dashamail.ru/smtp

В документации описаны методы для рассылок, списков, контактов, транзакционной отправки, вебхуки и т.д.

3. HTTP API и SMTP — в чём разница

• HTTP API — вы делаете запросы (GET/POST) к эндпоинтам DashaMail. Удобно для: добавления/обновления контактов, запуска рассылок, получения статистики, отправки транзакционных писем по сценарию. Авторизация по API-ключу, ответы в JSON (или как указано в доке).
• SMTP — отправка по протоколу почты. Сервер: smtps.dashasender.ru, порты 25, 2525 (TLS) или 465 (SSL). Подходит, когда ваше приложение уже умеет отправлять почту через SMTP и вы хотите просто перенаправить отправку через DashaMail. Нужен настроенный домен с DKIM и SPF.

Для интеграции с сайтом/сервисом (транзакционные письма, синхронизация контактов) обычно выбирают HTTP API.

4. Отправка писем через API

В документации есть метод(ы) для отправки транзакционных писем: в запросе передаются отправитель, получатель, тема, тело (HTML/текст) или id шаблона и переменные. Ответ содержит статус отправки или код ошибки. Рекомендуется обрабатывать ошибки и повторные попытки при сбоях.

5. Синхронизация контактов

Через API доступны методы работы со списками и контактами: создание/обновление контактов, подписка/отписка, импорт. Это позволяет держать базу в DashaMail в актуальном состоянии из вашей CRM или сайта.

Кратко

API-ключ берётся в кабинете в разделе «Интеграции». Документация — на docs.dashamail.ru и страницах про транзакционную отправку и SMTP. Для интеграции сервиса с транзакционными письмами и контактами используйте HTTP API; SMTP подойдёт, если удобнее отправлять через классический почтовый протокол.