Produto

REST API

Envie com um pedido JSON.

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>"
}

Autenticação

Envie uma chave srs_live_ com escopo emitida pelo painel como token Bearer. Cada chave tem seus próprios scopes (emails:send, webhooks:write …); chaves revogadas ou expiradas são rejeitadas com 401.

Recursos principais

POST /v1/emails — enfileira uma mensagem
POST /v1/emails/batch — até 100 mensagens por solicitação
GET /v1/emails — lista mensagens recentes
GET /v1/emails/{id} — estado da mensagem
DELETE /v1/emails/{id}/schedule — cancela um envio agendado

Modelo de resposta

202 significa enfileirado, não entregue na caixa de entrada. 403 pode indicar escopo ausente ou domínio não verificado. 422 bloqueia um destinatário suprimido. 429 indica limitação de taxa (rate limiting).

Limites atuais do serviço

A API REST rejeita anexos. Aceita apenas os cabeçalhos personalizados In-Reply-To, References, List-Unsubscribe e List-Unsubscribe-Post (até 8). O correio hospedado é separado: o cliente web aceita 20 anexos, 25 MiB no total; o cliente desktop publicado limita o envio a 10 MiB. HTTP 202 e email.accepted indicam aceitação para processamento; a aceitação SMTP não garante entrega nem chegada à caixa de entrada.