Documentación de MailAPI

Bienvenido a MailAPI

MailAPI es un servicio profesional de envío de correos electrónicos diseñado para desarrolladores que necesitan integración sencilla y alta confiabilidad en sus aplicaciones.

Con nuestra API RESTful, puedes enviar correos electrónicos con solo unas pocas líneas de código, sin preocuparte por la infraestructura de envío.

Seguridad

Autenticación con token seguro para proteger tus envíos.

Fácil Integración

Endpoints simples y documentación clara para una implementación rápida.

HTML Soportado

Envía correos con contenido HTML personalizado para mejor engagement.

Comenzar Rápido

Envía tu primer email en menos de 5 minutos con nuestro ejemplo de código listo para usar. Solo necesitas obtener tu token y hacer una petición HTTP.

Python
JavaScript
cURL

Ejemplo en Python

import requests

# Primero obtén tu token
register_url = "https://api2mail.vercel.app/credential/register"
register_data = {
    "email": "tu_email@ejemplo.com",
    "password": "tu_contraseña_segura"
}

register_response = requests.post(register_url, json=register_data)
token = register_response.json()["token"]

# Luego envía un email
send_url = "https://api2mail.vercel.app/send-email"
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}

email_data = {
    "to": "destinatario@ejemplo.com",
    "subject": "Asunto del correo",
    "htmlBody": "<h1>Hola</h1><p>Este es un correo de prueba.</p>",
    "fromName": "Mi Servicio"
}

send_response = requests.post(send_url, headers=headers, json=email_data)
print(send_response.json())

Ejemplo en JavaScript

// Primero obtén tu token
const register = async () => {
    const registerResponse = await fetch("https://api2mail.vercel.app/credential/register", {
        method: "POST",
        headers: {
            "Content-Type": "application/json"
        },
        body: JSON.stringify({
            email: "tu_email@ejemplo.com",
            password: "tu_contraseña_segura"
        })
    });
  
    const registerData = await registerResponse.json();
    return registerData.token;
};

// Luego envía un email
const sendEmail = async (token) => {
    const sendResponse = await fetch("https://api2mail.vercel.app/send-email", {
        method: "POST",
        headers: {
            "Authorization": "Bearer " + token,
            "Content-Type": "application/json"
        },
        body: JSON.stringify({
            to: "destinatario@ejemplo.com",
            subject: "Asunto del correo",
            htmlBody: "<h1>Hola</h1><p>Este es un correo de prueba.</p>",
            fromName: "Mi Servicio"
        })
    });
  
    return await sendResponse.json();
};

// Ejecutar el flujo
register().then(token => {
    sendEmail(token).then(response => {
        console.log(response);
    });
});

Ejemplo con cURL

# Primero obtén tu token
curl -X POST \
    https://api2mail.vercel.app/credential/register \
    -H "Content-Type: application/json" \
    -d '{
        "email": "tu_email@ejemplo.com",
        "password": "tu_contraseña_segura"
    }'

# Luego usa el token para enviar un email
curl -X POST \
    https://api2mail.vercel.app/send-email \
    -H "Authorization: Bearer TU_TOKEN_AQUI" \
    -H "Content-Type: application/json" \
    -d '{
        "to": "destinatario@ejemplo.com",
        "subject": "Asunto del correo",
        "htmlBody": "

Hola

Este es un correo de prueba.

", "fromName": "Mi Servicio" }'

Obtener Token de Acceso

Para usar la API, primero necesitas obtener un token de acceso mediante el endpoint de registro.

Endpoint de Registro

POST https://api2mail.vercel.app/credential/register

Cuerpo de la Solicitud

{
    "email": "tu_email@ejemplo.com",
    "password": "tu_contraseña_segura"
}

Respuesta Exitosa

{
    "message": "Te recomendamos guardar bien el token",
    "token": "*********************************************fe8ca967a264fad"
}

Recomendaciones de Seguridad

  • Guarda tu token en un lugar seguro
  • No compartas tu token con nadie
  • Usa contraseñas seguras para el registro
  • Si comprometes tu token, registra una nueva cuenta

Envío de Emails

Una vez que tienes tu token, puedes usarlo para enviar correos electrónicos con contenido HTML personalizado.

Endpoint de Envío

POST https://api2mail.vercel.app/send-email

Encabezados Requeridos

Authorization: Bearer TU_TOKEN_AQUI
Content-Type: application/json

Cuerpo de la Solicitud

{
    "to": "destinatario@ejemplo.com",
    "subject": "Asunto del correo",
    "htmlBody": "<h1 style='color: blue;'>Hola</h1><p>Este es un correo con <strong>HTML</strong>.</p>"
}

Respuesta Exitosa

{
    "message": "Correo electrónico enviado exitosamente"
}

Consejos

  • Puedes usar HTML completo en el campo htmlBody
  • Incluye estilos inline para mejor compatibilidad
  • Prueba siempre con una dirección de correo propia primero
  • Mantén tu token seguro en cada solicitud

Soporte

Si necesitas ayuda con la API o tienes alguna pregunta, puedes contactarnos de las siguientes formas:

GitHub

Reporta issues o consulta el código en nuestro repositorio oficial .

Contribuir

Si eres desarrollador, puedes contribuir al proyecto mediante pull requests.

Preguntas

Para preguntas específicas, abre un issue en GitHub con la etiqueta "question".