E-Mail-API vs. SMTP: Was ist der Unterschied, und was sollten Sie verwenden?

Die Kurzfassung

1. Zwei Wege, eine Nachricht zu übergeben. Beide Schnittstellen erfüllen dieselbe Aufgabe: Ihre Anwendung übergibt eine Nachricht an einen Versanddienst, und der Dienst liefert sie an den Mailserver des Empfängers aus.
2. Wie SMTP für eine Anwendung funktioniert. SMTP ist das Protokoll, das Mailserver seit Jahrzehnten verwenden, und fast jede Programmiersprache, jedes Framework und jede Software hat eine Bibliothek dafür.
3. Wie eine E-Mail-API funktioniert. Ein API-Aufruf ist eine HTTPS-Anfrage, meist mit einem JSON-Body, der Absender, Empfänger, Betreff und Inhalt benennt.
4. Unterschiede, auf die es ankommt. Die Einrichtung geht per SMTP am schnellsten, wenn die Software bereits E-Mails sendet.
5. Fehler, Wiederholungen und Feedback. Welche Schnittstelle Sie auch nutzen: Eine erfolgreiche Übergabe bedeutet nur, dass der Dienst die Nachricht angenommen hat.
6. Sicherheit. Behandeln Sie SMTP-Passwörter und API-Schlüssel als Geheimnisse.

Zwei Wege, eine Nachricht zu übergeben

Beide Schnittstellen erfüllen dieselbe Aufgabe: Ihre Anwendung übergibt eine Nachricht an einen Versanddienst, und der Dienst liefert sie an den Mailserver des Empfängers aus. Der Unterschied liegt darin, wie die Übergabe funktioniert.

Bei SMTP spricht Ihre Anwendung das Mailprotokoll mit einem Relay. Bei einer API stellt sie eine gewöhnliche Webanfrage, und der Dienst baut die Nachricht für Sie zusammen.

Wie SMTP für eine Anwendung funktioniert

SMTP ist das Protokoll, das Mailserver seit Jahrzehnten verwenden, und fast jede Programmiersprache, jedes Framework und jede Software hat eine Bibliothek dafür. Sie geben Host, Port, Sicherheitsmodus und Zugangsdaten an, und die Bibliothek übermittelt die Nachricht.

Host: smtp.example.com
Port: 587 (STARTTLS)
Username and password: from your account

Verwenden Sie Port 587 mit STARTTLS oder Port 465 mit implizitem TLS; das sind die Submission-Ports für Anwendungen, die sich anmelden. Für jede Phase kommt ein Antwortcode zurück, etwa 250 für akzeptiert, sodass Ihr Code erkennen kann, ob das Relay die Nachricht angenommen hat.

Wie eine E-Mail-API funktioniert

Ein API-Aufruf ist eine HTTPS-Anfrage, meist mit einem JSON-Body, der Absender, Empfänger, Betreff und Inhalt benennt. Sie authentifizieren sich mit einem API-Schlüssel, und die Antwort teilt Ihnen mit, ob die Anfrage akzeptiert wurde, und gibt ihr eine Kennung, die Sie später verwenden können.

POST /v1/messages
Authorization: Bearer <api key>
{"from":"you@example.com","to":"them@example.com","subject":"Hello"}

Da die Anfrage aus strukturierten Daten besteht, kann eine API Dinge tun, die über SMTP umständlich sind: eine Nachricht mit je eigenem Wert an viele Empfänger senden, eigene Labels zur Nachverfolgung anhängen, ein gespeichertes Template wählen und seine Variablen füllen.

Unterschiede, auf die es ankommt

Die Einrichtung geht per SMTP am schnellsten, wenn die Software bereits E-Mails sendet. Die Kontrolle ist bei einer API größer, denn sie liefert strukturierte Fehler und akzeptiert Optionen, für die ein Mailprotokoll keinen Platz hat. Eine einzige API-Anfrage kann viele Empfänger enthalten, während SMTP eine Transaktion pro Nachricht oder pro Charge braucht.

Die Zustellung ist in beiden Fällen gleich: Der Versanddienst signiert die Nachricht, wählt eine IP und spricht mit dem Server des Empfängers. Keine der Schnittstellen bringt eine Nachricht allein in den Posteingang. Das leisten Authentifizierung und Reputation.

Fehler, Wiederholungen und Feedback

Welche Schnittstelle Sie auch nutzen: Eine erfolgreiche Übergabe bedeutet nur, dass der Dienst die Nachricht angenommen hat. Ob sie den Empfänger erreicht hat, wird später gemeldet, als Zustellung, Bounce oder Beschwerde. Nutzen Sie Webhooks oder das Ereignislog, um diese Ergebnisse zu erhalten.

Wiederholen Sie nur, was aus einem vorübergehenden Grund fehlgeschlagen ist. Bei einem Timeout oder einer 4xx-Antwort lohnt sich eine Wiederholung mit Verzögerung, während eine 5xx-Antwort oder eine abgelehnte Adresse jedes Mal fehlschlägt, sodass Wiederholungen nur Last erzeugen.

Sicherheit

Behandeln Sie SMTP-Passwörter und API-Schlüssel als Geheimnisse. Bewahren Sie sie in Umgebungseinstellungen auf, nie im Quellcode oder in einer mobilen App, und geben Sie jeder Anwendung einen eigenen Schlüssel, damit Sie einen sperren können, ohne die anderen zu beeinträchtigen.

Bevorzugen Sie Schlüssel, die auf das Senden beschränkt sind, rotieren Sie sie nach einem festen Zeitplan und verwenden Sie stets eine verschlüsselte Verbindung. Beide Schnittstellen sollten über TLS genutzt werden.

So wählen Sie

Wählen Sie SMTP, wenn Sie Software anbinden, die bereits E-Mails sendet, etwa ein CMS, ein Helpdesk oder eine ältere Anwendung. Wählen Sie die API für neuen Code, wenn Sie Templates, Werte pro Empfänger, Tags und strukturierte Antworten wünschen.

Sie sind nicht festgelegt. Beide teilen sich Ihre Domain, IPs und Unterdrückungslisten, sodass ein Team mit SMTP starten und die stark genutzten Pfade später nach und nach auf die API umstellen kann.

Weiterführende Literatur und Quellen

• RFC 6409: Message Submission for Mail
• RFC 8314: Cleartext Considered Obsolete: TLS for email submission
• Google: Richtlinien für E-Mail-Absender

In MigoSMTP umsetzen: Artikel im Help-Center

• Sicherheit und Rotation von API-Schlüsseln
• Webhooks und Zustellereignisse
• SMTP-Einstellungen: Ports, TLS und Authentifizierung

Verwandte Leitfäden und Tools

• E-Mail-API: Die API und ihren Umfang ansehen.
• SMTP-Relay: Bestehende Software anbinden.
• Transaktions-E-Mail: Was sie ist und wie Sie sie gut versenden.
• SMTP-Relay erklärt: Wie ein Relay funktioniert.