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.
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".