SMTP-Relay
Das BillionSend-SMTP-Relay mit jedem SMTP-Client oder Framework-Mailer nutzen: Host, Ports, TLS, Limits, Ratenlimits und alle Antwortcodes.
Das SMTP-Relay nimmt E-Mails von jedem SMTP-Client oder Framework-Mailer entgegen und sendet sie wie POST /emails: mit denselben Absenderprüfungen, Sperrlisten, Tariflimits und Events.
Verbinden
| Einstellung | Wert |
|---|---|
| Host | smtp.billionsend.com |
| Port, STARTTLS | 587 |
| Port, implizites TLS | 465 |
| Benutzername | billionsend |
| Passwort | Ein API-Schlüssel (bs_...), zum Beispiel ein SMTP-Zugang von der Seite SMTP (siehe API-Schlüssel) |
TLS ist auf beiden Ports Pflicht. Ein Schlüssel, der nur zum Senden dient oder auf eine Domain oder ein Postfach beschränkt ist, behält diese Beschränkungen auch über 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
Was das Relay prüft
- Die
From-Adresse muss zu einer verifizierten Domain des Teams des Schlüssels gehören. - Ein nicht leerer
Subjectund ein HTML- oder Textkörper sind Pflicht. - Eine Nachricht darf bis zu 40 MiB groß sein und bis zu 50 Empfänger haben.
- Für Anhänge gelten dieselben Regeln wie in der API: Programme und getarnte Dateitypen werden abgelehnt.
- Für Header gilt dieselbe Allowlist wie bei
POST /emails(X-*-Namen, Threading, Priorität,List-Unsubscribe). Alle anderen Header schreibt BillionSend selbst. - Drei fehlgeschlagene Anmeldungen beenden die Verbindung. Eine Sitzung dauert höchstens 15 Minuten, und eine IP-Adresse kann höchstens 10 Verbindungen halten.
Ratenlimits und Wiederholungen
E-Mails zählen auf dasselbe Limit pro Minute wie die API-Anfragen des Schlüssels. Darüber antwortet das Relay mit 451 4.7.1 und der Wartezeit in Sekunden. SMTP-Clients wiederholen das von selbst.
Wenn ein Client das abschließende 250 nie gesehen hat und dieselbe Nachricht mit derselben Message-ID erneut sendet, erhält er die erste Antwort zurück statt einer zweiten E-Mail.
Fehler
| Antwort | Bedeutung |
|---|---|
530 / 535 |
Fehlende oder falsche Zugangsdaten |
550 |
Absender für diesen Schlüssel nicht erlaubt, ein Empfänger, der keine E-Mails empfangen kann, alle Empfänger gesperrt oder ein gesperrtes Team |
552 |
Nachricht oder Anhang zu groß |
553 |
Fehlender Betreff oder fehlerhafte Adresse |
554 |
Nachricht abgelehnt, zum Beispiel wegen einer nicht verifizierten Absenderdomain oder eines nicht erlaubten Headers |
451 |
Vorübergehend: Limit pro Minute überschritten (4.7.1, mit der Wartezeit in Sekunden) oder Versand pausiert, bis sich Ihre Raten erholen. Wiederholen. |
452 |
Mehr als 50 Empfänger (den Rest in einer weiteren Nachricht senden) oder ein Kontingent ist aufgebraucht: Der Tagesstau ist voll, das Monatsvolumen ist verbraucht (es wird mit der Verlängerung des Zeitraums frei), der Stau der Aufwärmphase einer neuen Domain ist voll oder das tägliche Sendelimit des Postfachs ist erreicht |