Эндпоинты API v2 /emails теперь доступны

Мы рады сообщить, что эндпоинты для работы с письмами теперь доступны в API v2! Теперь вы можете отправлять, получать, обновлять запланированные письма и отменять ожидающие отправки письма — всё это через наш мощный REST API.

Новые эндпоинты

Отправка письма

POST /v2/emails

Отправьте одно письмо одному или нескольким получателям. Эндпоинт отправки поддерживает:

• Множественных получателей — Отправка до 50 получателей (TO, CC, BCC суммарно)
• Шаблоны — Использование псевдонимов или ID шаблонов с подстановкой переменных через синтаксис {{переменная}}
• Вложения — Включение файлов через base64-контент или URL
• Планирование — Планирование писем на будущую доставку с использованием ISO 8601, Unix-временных меток или естественного языка вроде "завтра в 9 утра"
• Отслеживание — Переопределение настроек отслеживания домена для открытий и кликов
• Метаданные — Прикрепление пользовательских пар ключ-значение, которые сохраняются и возвращаются вместе с письмом
• Идемпотентность — Предотвращение дублирования отправок с помощью заголовка Idempotency-Key

Каждый получатель получает свой уникальный ID письма для индивидуального отслеживания при отправке на несколько адресов.

Получение письма

GET /v2/emails/{id}

Получите подробную информацию о конкретном письме, включая:

• Текущий статус (ожидает, запланировано, отправлено, доставлено, отклонено, отменено)
• Исходные заголовки и содержимое письма
• Настройки отслеживания
• Пользовательские метаданные
• Временные метки создания и обновлений

Обновление запланированного письма

POST /v2/emails/{id}

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

Отмена письма

POST /v2/emails/{id}/cancel

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

Ограничения скорости

Каждый ответ включает заголовки ограничения скорости, чтобы вы могли отслеживать свое использование:

• ratelimit-limit — Максимум запросов в секунду
• ratelimit-remaining — Оставшиеся запросы в текущей секунде
• ratelimit-daily-limit — Максимум ежедневных запросов
• ratelimit-daily-remaining — Оставшиеся ежедневные запросы

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

Полная документация с примерами кода на Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET и cURL доступна по ссылкам:

• Отправка письма
• Получение письма
• Обновление запланированного письма
• Отмена письма

Скоро: API для шаблонов

Мы работаем над API для шаблонов, который позволит вам создавать, обновлять и управлять шаблонами писем программно. Следите за этим захватывающим дополнением!

Уведомление об устаревании API v1

Важно: API v1 признан устаревшим и перестанет функционировать в конце февраля 2026 года. Если вы всё ещё используете API v1, пожалуйста, перейдите на API v2 как можно скорее.

Нужна помощь с миграцией? Ознакомьтесь с нашей документацией API v2 или обратитесь к нашей службе поддержки.