REST API

Envie com um pedido JSON.

Recursos principais

POST /v1/emails — enfileira uma mensagem GET /v1/emails/{id} — consulta o estado da mensagem

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.

Modelo de acesso atual

As chaves atuais usam srs_live_. Antes de verificar o domínio From, o remetente sandbox compartilhado só envia a membros do projeto. Depois valem cotas, suppression, limites de destinatários e controles de abuso. 202 significa enfileirado, não entregue.

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