REST API

Отправка одним JSON-запросом.

Основные ресурсы

POST /v1/emails — поставить сообщение в очередь GET /v1/emails/{id} — статус сообщения

Модель ответа

202 означает «поставлено в очередь», а не «доставлено во входящие». 403 указывает на отсутствие scope или неверифицированный домен. 422 блокирует suppressed-получателя. 429 — превышен лимит запросов.

Текущие ограничения сервиса

REST API отклоняет вложения. Из произвольных заголовков принимаются только In-Reply-To, References, List-Unsubscribe и List-Unsubscribe-Post (до 8). Обычная почта работает отдельно: веб-клиент поддерживает до 20 вложений, всего 25 МиБ; выпущенный настольный клиент ограничивает отправку 10 МиБ. HTTP 202 и email.accepted означают приём в обработку; принятие SMTP-сервером не гарантирует доставку или попадание во входящие.

Актуальная модель доступа

Текущие ключи dashboard используют префикс srs_live_. До проверки клиентского From-домена общий sandbox-отправитель может писать только участникам проекта. После проверки DNS внешняя отправка ограничивается квотами тарифа, suppression, лимитами получателей и abuse-контролями. Ответ 202 означает очередь, а не доставку.

POST /v1/emails

POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json

{
  "from": "Sender Name <info@example.com>",
  "to": ["user@example.net"],
  "subject": "Reset your password",
  "html": "<p>Click to reset your password.</p>"
}

REST API

Ресурсы