Documentación de la API de envío

Una API para enviar correos de registro, recuperación de contraseña y notificaciones desde tu sitio — sin montar SMTP.

Obtén una API key

Disponible ahora La propiedad, MX, SPF, DKIM y DMARC se verifican por separado. Una vez listos, envía con una API key y consulta en el panel los resultados por destinatario: entregados, fallidos y pendientes.

Inicio rápido

  1. 1

    Vincula un dominio

    Añade tu dominio de envío en Envío para sitios.

  2. 2

    Verifica el DNS

    Añade los registros SPF / DKIM / DMARC y el TXT de verificación, y verifica con un clic.

  3. 3

    Crea una clave

    Crea una clave te_live_ — el texto se muestra una sola vez, guárdalo entonces.

Enviar un correo

Una petición POST con tu clave te_live_ en el header Authorization.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Campos de la solicitud

from Dirección del remitente, debe estar en un dominio verificado
to Dirección del destinatario (única o array)
subject Asunto del correo
html / text Cuerpo del correo (HTML o texto plano)
Idempotency-Key Header opcional; reutiliza el valor en reintentos para evitar envíos duplicados

Una solicitud aceptada devuelve HTTP 202 con un id y estado accepted. Con la misma API key, GET /api/sending/messages/{id} devuelve por destinatario: entregado, fallido, pendiente o desconocido.

Errores y límites

401 Clave inválida o revocada — regenera una clave te_live_
403 Dominio del remitente no verificado, o dirección fuera de un dominio verificado
429 Tasa de envío superada; la respuesta trae retry_after — reintenta luego según se indica
503 Motor de correo no disponible temporalmente; reintenta con la misma Idempotency-Key

El número de destinatarios, el tamaño del cuerpo y la tasa tienen límites de protección. El uso se cuenta solo tras la validación, así las solicitudes inválidas no agotan tu cuota.

¿Listo para integrar?

Obtén una API key Ver preguntas frecuentes