REST API

Envía con una solicitud JSON.

Recursos principales

POST /v1/emails — pone en cola un mensaje GET /v1/emails/{id} — consulta el estado del mensaje

Modelo de respuesta

202 significa en cola, no entregado en la bandeja de entrada. 403 puede indicar falta de scope o un dominio sin verificar. 422 bloquea a un destinatario suprimido. 429 indica limitación de tasa (rate limiting).

Límites actuales del servicio

La API REST rechaza adjuntos. Solo admite los encabezados personalizados In-Reply-To, References, List-Unsubscribe y List-Unsubscribe-Post (hasta 8). El correo alojado es independiente: la web admite hasta 20 adjuntos y 25 MiB en total; el cliente de escritorio publicado limita los envíos a 10 MiB. HTTP 202 y email.accepted significan aceptación para procesamiento; la aceptación SMTP no garantiza entrega ni llegada a la bandeja de entrada.

Modelo de acceso actual

Las claves actuales usan srs_live_. Antes de verificar el dominio From, el remitente sandbox compartido solo puede escribir a miembros del proyecto. Después, rigen cuotas, suppression, límites de destinatarios y controles de abuso. 202 significa en cola, no entregado.

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