Аутентификация
Передавайте scoped-ключ srs_live_ из панели как Bearer-токен. У каждого ключа свой набор scope (emails:send, webhooks:write …); отозванные или истёкшие ключи отклоняются с кодом 401.
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>"
}Основные ресурсы
- POST /v1/emails — поставить письмо в очередь
- POST /v1/emails/batch — до 100 писем одним запросом
- GET /v1/emails — список последних писем
- GET /v1/emails/{id} — статус письма
- DELETE /v1/emails/{id}/schedule — отменить отложенную отправку
Модель ответа
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-сервером не гарантирует доставку или попадание во входящие.