Aller au contenu
Esc
↑↓naviguer↵ouvrir⌘Japerçu
Sur cette page

Relais SMTP

Utilisez le relais SMTP de BillionSend depuis n'importe quel client SMTP ou module d'envoi de framework : hôte, ports, TLS, limites et chaque code de réponse.

Le relais SMTP reçoit les e-mails de n’importe quel client SMTP ou module d’envoi de framework et les envoie comme POST /emails : mêmes vérifications de l’expéditeur, mêmes suppressions, mêmes limites de forfait et mêmes événements.

Se connecter

Paramètre Valeur
Hôte smtp.billionsend.com
Port, STARTTLS 587
Port, TLS implicite 465
Nom d’utilisateur billionsend
Mot de passe Une clé d’API (bs_...), par exemple un identifiant SMTP de la page SMTP (voir Clés API)

TLS est obligatoire sur les deux ports. Une clé réservée à l’envoi, ou limitée à un domaine ou à une boîte de réception, conserve ces limites en SMTP.

curl --ssl-reqd smtp://smtp.billionsend.com:587 \
  --user "billionsend:$BILLIONSEND_API_KEY" \
  --mail-from hello@mail.example.com \
  --mail-rcpt success@simulator.amazonses.com \
  -T message.eml

Ce que le relais vérifie

  • L’adresse From doit appartenir à un domaine vérifié de l’équipe de la clé.
  • Un Subject non vide et un corps HTML ou texte sont obligatoires.
  • Un message peut faire jusqu’à 40 MiB et compter jusqu’à 50 destinataires.
  • Les pièces jointes suivent les mêmes règles que l’API : les programmes et les types de fichiers déguisés sont refusés.
  • Les en-têtes suivent la même liste d’autorisation que POST /emails (noms X-*, chaînage des fils, priorité, List-Unsubscribe). BillionSend écrit lui-même tous les autres en-têtes.
  • Trois échecs de connexion ferment la connexion. Une session dure 15 minutes au plus, et une même adresse IP peut garder 10 connexions au plus.

Limites de débit et nouvelles tentatives

Les messages comptent dans la même limite par minute que les requêtes d’API de la clé. Au-delà, le relais répond 451 4.7.1 avec le nombre de secondes à attendre. Les clients SMTP réessaient d’eux-mêmes.

Si un client n’a jamais vu le 250 final et renvoie le même message avec le même Message-ID, il reçoit de nouveau la première réponse au lieu d’un second e-mail.

Erreurs

Réponse Signification
530 / 535 Identifiants manquants ou incorrects
550 Expéditeur non autorisé pour cette clé, destinataire qui ne peut pas recevoir d’e-mails, tous les destinataires sur la liste de suppression, ou équipe suspendue
552 Message ou pièce jointe trop volumineux
553 Objet manquant ou adresse mal formée
554 Message refusé, par exemple domaine d’expéditeur non vérifié ou en-tête non autorisé
451 Temporaire : limite par minute dépassée (4.7.1, avec le nombre de secondes à attendre) ou envoi suspendu le temps que vos taux se rétablissent. Réessayez.
452 Plus de 50 destinataires (envoyez les autres dans un second message), ou un quota est épuisé : la file d’attente quotidienne est pleine, le volume mensuel est atteint (il se libère au renouvellement de la période), la file de préchauffage d’un nouveau domaine est pleine, ou la limite d’envoi quotidienne de la boîte de réception est atteinte

Cette page vous a-t-elle été utile ?