Authentification
Envoyez une clé srs_live_ à portée limitée émise par le tableau de bord comme jeton Bearer. Chaque clé a ses propres scopes (emails:send, webhooks:write …) ; les clés révoquées ou expirées sont rejetées avec 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>"
}Ressources principales
- POST /v1/emails — met un message en file d’attente
- POST /v1/emails/batch — jusqu’à 100 messages par requête
- GET /v1/emails — liste les messages récents
- GET /v1/emails/{id} — état d’un message
- DELETE /v1/emails/{id}/schedule — annule un envoi programmé
Modèle de réponse
202 signifie mis en file d'attente, pas livré en boîte de réception. 403 peut indiquer une portée manquante ou un domaine non vérifié. 422 bloque un destinataire supprimé. 429 indique une limitation de débit.
Limites actuelles du service
L’API REST refuse les pièces jointes. Seuls les en-têtes personnalisés In-Reply-To, References, List-Unsubscribe et List-Unsubscribe-Post sont acceptés (8 au maximum). Le courrier hébergé est distinct : le client web accepte 20 pièces jointes, 25 MiB au total ; le client de bureau publié limite l’envoi à 10 MiB. HTTP 202 et email.accepted indiquent une prise en charge ; l’acceptation SMTP ne garantit ni livraison ni arrivée dans la boîte de réception.