Integración API REST

Aprende a conectar tus sistemas y enviar correos instantáneos mediante solicitudes HTTP JSON.

			⚡ Envíos Inmediatos por API: Con la API REST de EasyEmailTemplate,
			puedes detonar el envío de una plantilla mapeada previamente desde
			cualquier lenguaje de programación o herramienta externa en
			milisegundos, inyectando variables dinámicas y procesándolas a través
			de tu propio servidor SMTP.
		

1. ¿Qué son los Placeholders?

Los placeholders (o variables dinámicas) son marcas de posición en el HTML de tu plantilla que se reemplazan en tiempo de ejecución por datos reales proporcionados en el JSON de tu solicitud API.

Se definen utilizando la sintaxis de doble llave: {{nombre_variable}} .

Mapeo dinámico: Las llaves en la plantilla HTML son sustituidas automáticamente por los valores enviados en el JSON.

2. Estructura del Payload JSON

Para realizar un Envío Inmediato, envías una solicitud POST a nuestro endpoint de API especificando la clave de tu plantilla, el correo del destinatario y la lista de placeholders:

POST /api/v1/emails/send-immediate
Content-Type: application/json
Authorization: Bearer TU_API_KEY_AQUI

{
  "template_key": "recuperacion_password_v1",
  "recipient_email": "usuario@ejemplo.com",
  "placeholders": {
    "user_name": "Carlos Mendoza",
    "token_otp": "849201",
    "user_email": "usuario@ejemplo.com"
  }
}

3. Flujo Arquitectónico del Envío

Así viaja la información desde tu aplicación hasta la bandeja de entrada del cliente final:

Flujo de ejecución: Tu App invoca la API REST → EasyEmailTemplate fusiona el HTML → Se envía vía tu servidor SMTP.

4. ¿Desde qué herramientas puedes integrar?

La API REST es universal, lo que significa que puedes consumirla desde la solución más sencilla hasta la arquitectura empresarial más compleja:

🌐 Frontend Web (JavaScript / Fetch)

Ideal para prototipos rápidos o llamadas directamente desde el navegador o Node.js mediante fetch() o axios .

💻 Backend Tradicional (Java, Python, PHP, C#)

Integración en controladores web como Spring Boot, Django, Laravel o .NET Core enviando la petición antes o después de guardar en base de datos.

⚡ Serverless / Cloud Functions

Servicios como AWS Lambda, Google Cloud Functions o Azure Functions disparados por eventos de base de datos o Webhooks.

🛠️ Herramientas de Pruebas (Postman, cURL)

Prueba tus plantillas enviando comandos directos desde la terminal o mediante colecciones de Postman antes de escribir código.

5. Ejemplo Práctico en JavaScript (Fetch)

Copia y adapta este fragmento básico para realizar envíos directamente desde JavaScript:

const sendEmail = async () => {
    const response = await fetch('https://api.easyemailtemplate.com/v1/emails/send-immediate', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'Authorization': 'Bearer TU_API_KEY_AQUI'
        },
        body: JSON.stringify({
            template_key: "recuperacion_password_v1",
            recipient_email: "cliente@dominio.com",
            placeholders: {
                user_name: "Ana María",
                token_otp: "991823"
            }
        })
    });

    const result = await response.json();
    console.log("Estado de envío:", result);
};