MailLandDocs
Envoi d'emails

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

ParametreValeur
Hotesmtp.mail.land
Port 587Soumission avec STARTTLS (obligatoire)
AuthentificationRequise
Nom d'utilisateurN'importe quelle valeur (ex. : votre e-mail, ou apikey)
Mot de passeVotre cle API MailLand
Taille maximale du message15 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

nodemailer-config.js
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 421 transitoire. 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 :

LimiteValeur par defaut
Connexions par minute30
Connexions par heure300

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

CodeSignification
250Message accepte pour livraison
421Transitoire -- 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
451Transitoire : 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
550Permanent -- 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)
552Permanent -- 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 account

Un rejet permanent ressemble a :

550 5.7.1 Domain is not verified. Add DNS records at https://app.mail.land

Contrairement 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

FonctionnaliteAPI RESTSMTP Relay
ProtocoleHTTPSSMTP
AuthentificationEn-tete X-API-KeySMTP AUTH (cle comme mot de passe)
ReponseAsynchrone (202 Accepted)Synchrone (250 OK ou erreur)
Pieces jointesBase64 dans JSONMIME standard
TemplatesChamp templateIdNon supporte (utiliser MIME)
Envoi planifieChamp scheduledAtNon supporte
SuiviChamp trackingConfigure par domaine
Variables par destinataireto[].variablesNon supporte
Envoi par lotEndpoint send-batchNon 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

Sur cette page