Ендпоінти API v2 /emails тепер доступні

З радістю повідомляємо, що ендпоінти електронної пошти тепер доступні в API v2! Тепер ви можете надсилати, отримувати, оновлювати заплановані листи та скасовувати очікувані листи — все це через наш потужний REST API.

Нові ендпоінти

Надіслати лист

POST /v2/emails

Надішліть один лист одному або кільком отримувачам. Ендпоінт надсилання підтримує:

• Кілька отримувачів — Надсилайте до 50 отримувачів (TO, CC, BCC разом)
• Шаблони — Використовуйте псевдоніми або ID шаблонів із заміною змінних за допомогою синтаксису {{variable}}
• Вкладення — Додавайте файли через base64 контент або URL
• Планування — Плануйте листи для майбутньої доставки, використовуючи ISO 8601, Unix timestamps або природну мову на кшталт "завтра о 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 або зверніться до нашої команди підтримки.