Conceptos
Idempotencia y sandbox
Cómo repetir una solicitud sin duplicar el email y cómo probar sin enviar de verdad.
Idempotencia
Envía x-idempotency-key en el POST /emails. Si la misma clave llega de nuevo en hasta 24 horas, la API devuelve el mismo email en vez de crear otro. Usa un id de tu dominio, como pedido-4821-enviado.
Los SDKs aceptan la clave como campo del envío (idempotencyKey) y la convierten en el header.
POST /emails
Sandbox
Con x-coffeemail-sandbox: true, el email pasa por todas las validaciones y genera eventos, pero no sale al destinatario. Sirve para pruebas automatizadas y entornos de desarrollo.
Las claves de prueba activan el sandbox solas. El plan debe incluir sandbox.