Вышло обновление 58: отправка копий писем и валидация адресов для всех (подробнее).

API и интеграции
Web API
Справочник Web API
SMTP API
История изменений API
Интеграции и библиотеки
Подключение Clickhouse в Яндекс.Облаке
<- Назад

История изменений API

22.02.2024 (v.1.58)

  • Добавлена возможность передачи заголовки “To”, “CC”, “BCC” в WEB API. Про особенности использования и имеющиеся ограничения можно прочитать здесь.

18.01.2024 (v.1.56)

  • новый параметр reply_to_name в методе email/send. Необязательное имя для ответов (если указан email reply_to и вы хотите, чтобы отображался не только этот email, но и имя).

27.09.2023 (v.1.52)

  • при использовании SMTP появилась возможность работы в строгом соответствии SMTP-стандарту, отправка без изменения MIME-заголовков "To:", "CC:", "BCC:". Для этого необходимо установить параметр strict в значение true в заголовке X-UNISENDER-GO, либо обратиться в техническую поддержку, чтобы вам включили strict=true для всех ваших писем без необходимости передачи дополнительного параметра в заголовке. Подробнее в SMTP API.
  • добавлено новое webhook событие "subscribed". Добавляйте его в отслеживаемые вами события и получайте информацию о повторной подписке ваших адресатов.
  • добавлен новый язык отписки "kz". Полный список поддерживаемых языков: “be”, “de”, “en”, “es”, “fr”, “it”, “pl”, “pt”, “ru”, "kz".

11.05.2023 (v.1.46)

  • добавлен новый метод валидации email адресов email-validation/single.
  • разрешена передача заголовка List-Unsubscribe-Post в методе email/send и SMTP, если у вас есть право отключать стандартный блок отписки.

01.03.2023 (v.1.44)

  • параметры message.custom_backend_id и message.smtp_pool_id в методе email/send теперь по умолчанию доступны всем пользователям без обращения в техподдержку.
  • новый параметр backend_id в методах project/create, project/update, project/list.

14.02.2023 (v.1.43)

  • добавлены новые параметры message.bypass_global, message.bypass_unavailable, message.bypass_unsubscribed и message.bypass_complained в методе email/send.

23.12.2022 (v.1.41)

  • новый параметр message.tags в методе email/send.
  • добавлены методы работы с метками tag/list и tag/delete.

18.10.2022 (v.1.38)

  • добавлены методы работы с выгрузкой событий в формате CSV: event-dump/*.
  • если пользователю разрешено отключать ссылку отписки, то он может и полностью отключить шаблонизатор, указав "template_engine":"none" в методе email/send или при отправке через SMTP.
  • переменная "campaign_id" в метаданных теперь обрабатывается специальным образом - можно использовать её как фильтр при вызове event-dump/create, позднее будет добавлен фильтр и в графическую статистику в личном кабинете. Можно использовать и другое имя переменной, обратившись в техподдержку.

24.06.2022 (v.1.34)

  • добавлены методы suppression/set и suppression/list.
  • если пользователю разрешено отключать ссылку отписки, то теперь разрешено и передавать заголовки References и In-Reply-To в дополнение к заголовкам List-Unsubscribe и пр.

18.03.2022 (v.1.31)

23.02.2022 (v.1.30)

  • новый параметр message.options.send_at в методе email/send.
  • добавлена возможность смены языка ссылки отписки путем передачи параметра message.global_language или заголовка X-UNISENDER-GO-Global-Language в методе email/send.
  • добавлена возможность выбора шаблонизатора через заголовок X-UNISENDER-GO-Template-Engine в методе email/send.

28.12.2021 (v.1.28)

05.06.2021 (v.1.19)

  • добавлены новые языки отписки. Полный список поддерживаемых языков: be, de, en, es, fr, it, pl, pt, ru, ua.

31.05.2021 (v.1.17)

  • новый параметр message.options.custom_backend_id в методе email/send.

17.03.2021 (v.1.16)

  • максимально разрешённый размер POST-запроса увеличен до 10МБ, при превышении возвращается HTTP-код 413 / API-код 199

24.02.2021 (v.1.15)

  • для статуса доставки soft_bounced добавлена гарантия повторных попыток в течение 2 суток.
  • добавлен параметр message.options.smtp_pool_id в метод email/send.
  • перечень доступных языков отписки расширен: en, ru, ua, es.
  • HTTP-коды ошибок приведены в семантическое соответствие с API-кодами. Полный перечень здесь.

04.01.2021 (v.1.14)

  • добавлен новый метод аутентификации: передача API ключа в HTTP-заголовке X-API-KEY
  • разрешена передача заголовков List-Unsubscribe, List-Subscribe, List-Help, List-Archive, List-Owner в методе email/send и SMTP, если у вас есть право отключать стандартный блок отписки.
  • В заголовках теперь поддерживаются подстановки переменных шаблонизатора.

07.12.2020 (v.1.13)

  • добавлен метод webhook/list
  • добавлено поле "status" к вебхукам, позволяющее отключать и возобновлять работу вебхуков без удаления
  • появилась авто-остановка с уведомлением по email неработоспособных вебхуков (все вызовы в течение последних 24 должны завершиться ошибкой, и таких вызовов должно быть не менее 10)

20.11.2020 (v1.12)

16.10.2020 (v1.11)

  • запущена обновлённая версия SMTP API

24.09.2020 (v1.10)

  • Добавлены новые параметры skip_unsubscribe и force_send в метод email/send
  • Параметр "metadata" метода email/send переименован в "global_metadata", но для обратной совместимости предыдущее имя также поддерживается.
  • Параметры метода email/subscribe переименованы для консистентности с параметрами email/send, но для обратной совместимости предыдущие имена также поддерживаются.

03.06.2020 (v1.7)

  • Добавлен Project API
  • Улучшена поддержка AMP: добавлен параметр message.body.amp в метод email/send, добавлен параметр template.body.amp в методы template/set, template/get, template/list, а параметр is_amp теперь игнорируется.
  • удалён устаревший параметр "login" из вебхуков, и добавлен новый параметр "project_name"

20.03.2020 (v1.5)

  • параметр username теперь игнорируется во всех методах, авторизация происходит исключительно по api key
  • в вебхуки добавлено поле user_id
  • удалены устаревшие методы: checked_email, set-domain, validate, getCheckedEmail, getSenderDomainList, setSenderDomain, validateSender