SMTP Relay
Envoyez des e-mails via le relais SMTP de Mail.Land en utilisant les protocoles SMTP standards
MailLand fournit un relais SMTP pour les applications qui envoient des e-mails via SMTP. Utilisez les memes identifiants API pour vous authentifier et envoyer via les ports SMTP standards.
Parametres de connexion
| Parametre | Valeur |
|---|---|
| Hote | smtp.mail.land |
| Port 587 | Soumission avec STARTTLS (obligatoire) |
| Authentification | Requise |
| Nom d'utilisateur | N'importe quelle valeur (ex. : votre e-mail, ou apikey) |
| Mot de passe | Votre cle API MailLand |
| Taille maximale du message | 15 Mo (15 728 640 octets) ; les messages plus volumineux sont refuses avec 552 |
En production, seul le port 587 (STARTTLS) est publie pour le relais. Le port 465 (TLS implicite) n'est pas publie, et le port 25 est route vers la passerelle entrante separee, pas vers le relais.
Authentification
L'authentification SMTP utilise votre cle API MailLand comme mot de passe. Le nom d'utilisateur peut etre n'importe quelle valeur -- MailLand l'ignore et s'authentifie uniquement sur la base de la cle API.
Votre identifiant doit avoir le canal Smtp active. Si votre identifiant n'a que le canal Api active, l'authentification SMTP sera rejetee.
Username: apikey
Password: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...L'e-mail et le mot de passe de votre compte ne sont pas acceptés pour SMTP. Créez un identifiant SMTP dans le panneau et utilisez-le comme mot de passe.
Exemples de configuration
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.',
});Application des regles d'identification
Les memes regles d'identification s'appliquent au SMTP et a l'API REST :
- Flux -- les identifiants transactionnels limitent a 5 destinataires par message ; les identifiants marketing autorisent jusqu'a 1 000 destinataires par message
- Perimetre de domaine -- si l'identifiant est limite a des domaines specifiques, le domaine d'envoi doit figurer dans la liste autorisee
- Liste blanche d'IP -- si l'identifiant a des restrictions IP, l'adresse IP de connexion doit etre autorisee
- Limites de debit -- les limites de l'identifiant par minute (si definie), par heure (1 000 par defaut) et par jour (10 000 par defaut) sont appliquees avant les limites du plan du workspace. Depasser l'une d'elles renvoie un
421transitoire. La limite par seconde n'est pas appliquee aujourd'hui - Mode : les identifiants sandbox acceptent et enregistrent l'e-mail mais ne le livrent jamais, quel que soit leur
sandboxBehavior
Limites de connexion IP
Independamment des limites de debit des identifiants, les connexions SMTP sont limitees par adresse IP :
| Limite | Valeur par defaut |
|---|---|
| Connexions par minute | 30 |
| Connexions par heure | 300 |
Ces limites s'appliquent avant l'authentification. En cas de depassement, la connexion est rejetee avec un message invitant a reessayer plus tard.
Codes de reponse SMTP
| Code | Signification |
|---|---|
250 | Message accepte pour livraison |
421 | Transitoire -- limite de debit de l'identifiant ou du workspace, quota ou cadence de prechauffage depassee. Reessayez plus tard ; ce n'est pas un rejet permanent |
451 | Transitoire : envoi suspendu par un pic de volume, une pause marketing ou un blocage de délivrabilité. Gardez le message en file d'attente et réessayez ; il est accepté dès que la pause est levée |
550 | Permanent -- domaine non verifie, expediteur/destinataire bloque, verification requise, ou limite de destinataires marketing (1 000 par message) depassee, ou tous les destinataires sont supprimes (5.7.1) |
552 | Permanent -- le message depasse la taille maximale (15 Mo), ses pieces jointes depassent 10 Mo au total une fois decodees, ou le message assemble depasse le budget de taille de la plateforme (5.3.4) |
Gestion des erreurs
Lorsqu'un message est rejete, la reponse SMTP inclut une raison lisible. Un rejet transitoire (reessayable) ressemble a :
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 rejet permanent ressemble a :
550 5.7.1 Domain is not verified. Add DNS records at https://app.mail.landContrairement a l'API REST (qui retourne 202 Accepted et traite de maniere asynchrone), SMTP peut rejeter les messages de maniere synchrone au niveau de la connexion pour les violations de domaine, de limite de debit et de quota.
SMTP vs API REST
| Fonctionnalite | API REST | SMTP Relay |
|---|---|---|
| Protocole | HTTPS | SMTP |
| Authentification | En-tete X-API-Key | SMTP AUTH (cle comme mot de passe) |
| Reponse | Asynchrone (202 Accepted) | Synchrone (250 OK ou erreur) |
| Pieces jointes | Base64 dans JSON | MIME standard |
| Templates | Champ templateId | Non supporte (utiliser MIME) |
| Envoi planifie | Champ scheduledAt | Non supporte |
| Suivi | Champ tracking | Configure par domaine |
| Variables par destinataire | to[].variables | Non supporte |
| Envoi par lot | Endpoint send-batch | Non supporte |
Etapes suivantes
- API REST -- envoyer des e-mails via l'API REST
- Cles API -- configurer le canal SMTP sur vos identifiants
- Configuration DNS -- configurer les enregistrements DNS pour votre domaine d'envoi