API de envío de correo
Envía desde tu propio dominio del lado del servidor, con la misma cuota, facturación y límites que el envío de correo de la consola. El dominio del remitente debe coincidir exactamente con un dominio de envío conectado y activo.
- Autenticación: la misma clave de API a nivel de usuario que usan las demás API abiertas de la plataforma
- Envío: POST /api/v1/mail/send; la respuesta se agrupa por destinatario y bounced_addrs es la única base para limpiar tu lista
- Idempotencia: con la cabecera Idempotency-Key, los reenvíos de la misma clave se envían una sola vez, sin entregas ni cobros duplicados
- Hilos de conversación: pasa in_reply_to y la cadena completa de references para que las respuestas caigan en la conversación original del destinatario
- Cuota y dominios: consulta la cuota restante de hoy y los dominios de envío utilizables para limitar el ritmo desde tu propio sistema
- Ejemplos de código: ejemplos mínimos funcionales en cURL / Node.js / Python / Go / PHP, cada uno con idempotencia y manejo de rebotes duros
Preguntas frecuentes
¿Un HTTP 200 significa que todos los destinatarios recibieron el correo?
No. Los resultados se agrupan por destinatario: un mensaje a cinco personas puede quedar en 2 entregados, 1 en cola y 2 con rebote duro. No hay webhook de rebotes, así que bounced_addrs es tu única base para la higiene de la lista; deja de enviar a esas direcciones de inmediato.
¿Cuándo es obligatoria la Idempotency-Key?
Siempre que tu llamada pueda reintentarse sola: reintentos por tiempo de espera, reentrega de una cola de trabajos o reintentos integrados en el SDK. Sin ella, un solo fallo de red hace que el destinatario reciba dos correos y que se te cobre dos veces, y ninguna de las dos cosas se puede revertir. Usa una clave de negocio como el id de la orden.
Páginas relacionadas: Documentación de la API de Tovanix · API de correo SMTP · Alta entregabilidad · Uso de la API de agregación SMTP
Cargando…