Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

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 Subject und 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

War diese Seite hilfreich?