Saltar al contenido principal
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
curl -X POST https://api.coffeemail.com.br/v1/product/emails \  -H "Authorization: Bearer $COFFEEMAIL_API_KEY" \  -H "x-idempotency-key: pedido-4821-enviado" \  -H "x-coffeemail-sandbox: true" \  -H "Content-Type: application/json" \  -d '{ "from": { "email": "pedidos@acme.com.br" }, "to": [{ "email": "ana@exemplo.com.br" }], "subject": "Teste", "html": "<p>Oi</p>" }'

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.