AutoMail

API de envío de correo

Envía emails con plantilla primordial (marca ldeluipy) desde cualquier aplicación mediante JSON + token. Adjuntos opcionales en base64.

Endpoint

POST https://automail.lu-zero.ldeluipy.es/api/send.php

Autenticación: cabecera Authorization: Bearer <token> o X-API-Token: <token>.

JSON de ejemplo

Texto plano (se convierte a HTML seguro dentro de la plantilla):

{
  "to": "mail@ejemplo.com",
  "subject": "Hola",
  "text": "hola que tal"
}

Con HTML propio (se envía multipart: texto + HTML con plantilla):

{
  "to": "mail@ejemplo.com",
  "subject": "Resumen",
  "html": "<p>hola que tal</p><p><strong>Importante</strong></p>"
}

Con adjunto (PDF, etc.):

{
  "to": "mail@ejemplo.com",
  "subject": "CV adjunto",
  "text": "Te envío el CV en PDF.",
  "attachments": [
    {
      "filename": "cv_ejemplo.pdf",
      "mime": "application/pdf",
      "content": "<BASE64>"
    }
  ]
}

Alias aceptados: mail, email, body, texto, asunto, files, adjuntos.

Adjuntos

Campo opcional attachments (también files / adjuntos): array de objetos.
Cada uno: filename (obligatorio), content base64 (obligatorio), mime (opcional; se infiere por extensión).
Límites: máx. 5 ficheros, ~5 MB por fichero, ~8 MB totales (configurables en el servidor).
MIME permitidos: application/pdf, text/plain, text/csv, image/png, image/jpeg, application/zip.
Sin adjuntos el comportamiento es idéntico al anterior.

curl

curl -sS -X POST 'https://automail.lu-zero.ldeluipy.es/api/send.php' \
  -H 'Authorization: Bearer TU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"to":"mail@ejemplo.com","text":"hola que tal"}'

Con PDF:

B64=$(base64 -w0 archivo.pdf)
curl -sS -X POST 'https://automail.lu-zero.ldeluipy.es/api/send.php' \
  -H 'Authorization: Bearer TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"to\":\"mail@ejemplo.com\",\"subject\":\"CV\",\"text\":\"Adjunto PDF\",\"attachments\":[{\"filename\":\"cv.pdf\",\"mime\":\"application/pdf\",\"content\":\"$B64\"}]}"

Respuestas

200 — {"ok":true,"to":"...","subject":"..."}; con adjuntos también attachments_count y attachments (nombres).
401 — token inválido o ausente
400 — JSON, campos, base64, MIME o límites incorrectos
500 — fallo SMTP (revisa logs del servidor)

Texto plano vs HTML

Mejor práctica: multipart alternative (texto + HTML). Esta API lo hace siempre. Con adjuntos: multipart/mixed envolviendo alternative + ficheros.

text — mensajes simples, máxima compatibilidad y accesibilidad.
html — formato rico; se sanea (sin scripts, iframes, eventos JS).
El HTML del usuario se inserta dentro de la plantilla con colores y marca primordial.

Gmail: cuenta y contraseña de aplicación

En Google Account → Seguridad → Verificación en 2 pasos (obligatorio) → Contraseñas de aplicaciones. Genera una para «Correo» u «Otro» y úsala como MAIL_PASSWORD en la config del servidor (sin espacios).

El remitente (MAIL_USERNAME / MAIL_FROM_ADDRESS) debe ser la misma cuenta Gmail.