Документация API отправки

Один API для писем регистрации, сброса пароля и уведомлений с вашего сайта — без SMTP.

Получить API-ключ

Доступно сейчас Право владения, MX, SPF, DKIM и DMARC проверяются отдельно. После готовности отправляйте с API-ключом и отслеживайте в консоли по получателям: доставлено, ошибка, в обработке.

Быстрый старт

  1. 1

    Привязать домен

    Добавьте домен отправки в «Рассылке для сайтов».

  2. 2

    Проверить DNS

    Добавьте записи SPF / DKIM / DMARC и TXT для проверки, затем проверьте в один клик.

  3. 3

    Создать ключ

    Создайте ключ te_live_ — открытый текст показывается один раз, сохраните сразу.

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

POST-запрос с ключом te_live_ в заголовке Authorization.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Поля запроса

from Адрес отправителя, должен быть в проверенном домене
to Адрес получателя (один или массив)
subject Тема письма
html / text Тело письма (HTML или обычный текст)
Idempotency-Key Необязательный заголовок; при повторах используйте то же значение во избежание дублей

Принятый запрос возвращает HTTP 202 с id и статусом accepted. С тем же ключом GET /api/sending/messages/{id} вернёт по получателям: доставлено, ошибка, в обработке или неизвестно.

Ошибки и лимиты

401 Ключ недействителен или отозван — создайте новый te_live_
403 Домен отправителя не проверен или адрес вне проверенного домена
429 Превышена скорость отправки; в ответе retry_after — повторите позже по указанию
503 Почтовый движок временно недоступен; повторите с тем же Idempotency-Key

Число получателей, размер тела и скорость имеют защитные лимиты. Учёт ведётся только после валидации, поэтому неверные запросы не расходуют вашу квоту.

Готовы интегрировать?

Получить API-ключ Открыть FAQ