SMTP Relay
Envíe correos electrónicos a través del SMTP relay de Mail.Land utilizando protocolos SMTP estándar
MailLand proporciona un SMTP relay para aplicaciones que envían correo electrónico por SMTP. Utilice las mismas credenciales API para autenticarse y enviar a través de puertos SMTP estándar.
Configuración de conexión
| Configuración | Valor |
|---|---|
| Host | smtp.mail.land |
| Puerto 587 | Envío con STARTTLS (obligatorio) |
| Autenticación | Requerida |
| Usuario | Cualquier valor (por ejemplo, su correo o apikey) |
| Contraseña | Su clave API de MailLand |
| Tamaño máximo de mensaje | 15 MiB (15.728.640 bytes); los mensajes más grandes se rechazan con 552 |
En producción, solo el puerto 587 (STARTTLS) está publicado para el relay. El puerto 465 (TLS implícito) no está publicado, y el puerto 25 se enruta a la puerta de enlace de entrada independiente, no al relay.
Autenticación
La autenticación SMTP utiliza su clave API de MailLand como contraseña. El nombre de usuario puede ser cualquier valor; MailLand lo ignora y se autentica exclusivamente con la clave API.
Su credencial debe tener el canal Smtp habilitado. Si su credencial solo tiene habilitado Api, la autenticación SMTP será rechazada.
Username: apikey
Password: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...El correo y la contraseña de su cuenta no se aceptan para SMTP. Cree una credencial SMTP en el panel y úsela como contraseña.
Ejemplos de configuración
const nodemailer = require('nodemailer');
const transporter = nodemailer.createTransport({
host: 'smtp.mail.land',
port: 587,
secure: false, // STARTTLS
auth: {
user: 'apikey',
pass: 'ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...',
},
});
await transporter.sendMail({
from: '"Your App" <[email protected]>',
to: '[email protected]',
subject: 'Hello from MailLand',
html: '<h1>Hello!</h1><p>Sent via SMTP relay.</p>',
text: 'Hello! Sent via SMTP relay.',
});Aplicación de credenciales
Las mismas reglas de credenciales aplican tanto para SMTP como para la REST API:
- Flujo: las credenciales transaccionales limitan a 5 destinatarios por mensaje; las credenciales de marketing permiten hasta 1.000 destinatarios por mensaje
- Alcance de dominio: si la credencial está limitada a dominios específicos, el dominio del remitente debe estar en la lista permitida
- Lista blanca de IP: si la credencial tiene restricciones de IP, la IP de conexión debe estar permitida
- Límites de velocidad: se aplican los límites de la credencial por minuto (si está definido), por hora (por defecto 1.000) y por día (por defecto 10.000) antes de los límites del plan del workspace. Superar uno de ellos devuelve un
421transitorio. El límite por segundo no se aplica hoy - Modo: las credenciales sandbox aceptan y registran el correo pero nunca lo entregan, sea cual sea su
sandboxBehavior
Límites de conexión por IP
Independientemente de los límites de velocidad de las credenciales, las conexiones SMTP tienen límite de velocidad por dirección IP:
| Límite | Valor predeterminado |
|---|---|
| Conexiones por minuto | 30 |
| Conexiones por hora | 300 |
Estos límites se aplican antes de la autenticación. Si se exceden, la conexión es rechazada con un mensaje para reintentar más tarde.
Códigos de respuesta SMTP
| Código | Significado |
|---|---|
250 | Mensaje aceptado para entrega |
421 | Transitorio: límite de velocidad de la credencial o del workspace, cuota o ritmo de calentamiento excedido. Reintente más tarde; no es un rechazo permanente |
451 | Transitorio: el envío está en pausa por un pico de volumen, una pausa de marketing o una retención de entregabilidad. Mantenga el mensaje en cola y reintente; se acepta en cuanto se levanta la pausa |
550 | Permanente: dominio no verificado, remitente/destinatario bloqueado, verificación requerida, o límite de destinatarios de marketing (1.000 por mensaje) excedido, o todos los destinatarios están suprimidos (5.7.1) |
552 | Permanente: el mensaje excede el tamaño máximo (15 MiB), sus adjuntos superan 10 MiB en total una vez decodificados, o el mensaje ensamblado supera el presupuesto de mensajes de la plataforma (5.3.4) |
Manejo de errores
Cuando un mensaje es rechazado, la respuesta SMTP incluye una razón legible. Un rechazo transitorio (reintentable) se ve así:
421 Try again later: rate limit exceeded
421 Try again later: monthly quota exceeded
421 Try again later: credential rate limit exceeded
451 4.7.0 Marketing emails are paused for this accountUn rechazo permanente se ve así:
550 5.7.1 Domain is not verified. Add DNS records at https://app.mail.landA diferencia de la REST API (que devuelve 202 Accepted y procesa de forma asíncrona), SMTP puede rechazar mensajes de forma síncrona a nivel de conexión por violaciones de dominio, límite de velocidad y cuota.
SMTP vs REST API
| Característica | REST API | SMTP Relay |
|---|---|---|
| Protocolo | HTTPS | SMTP |
| Autenticación | Encabezado X-API-Key | SMTP AUTH (clave como contraseña) |
| Respuesta | Asíncrona (202 Accepted) | Síncrona (250 OK o error) |
| Adjuntos | Base64 en JSON | MIME estándar |
| Plantillas | Campo templateId | No soportado (use MIME) |
| Envío programado | Campo scheduledAt | No soportado |
| Seguimiento | Campo tracking | Configurado por dominio |
| Variables por destinatario | to[].variables | No soportado |
| Envío por lotes | Endpoint send-batch | No soportado |
Próximos pasos
- REST API: envíe correos mediante la REST API
- Claves API: configure el canal SMTP en sus credenciales
- Configuración de dominio: configure los registros DNS para su dominio de envío