Leitfaden zur E-Mail-Infrastruktur
E-Mails per API senden
Eine Schritt-für-Schritt-Anleitung für den authentifizierten E-Mail-Versand per API, für Tests und einen sicheren Produktivbetrieb.
Eine produktive E-Mail-Anfrage braucht mehr als Empfänger und Betreff. Sie braucht einen verifizierten Absender, ein zweckgerechtes Template, Authentifizierung, Fehlerbehandlung und eine Möglichkeit, das Ergebnis zu beobachten.
Was das in der Praxis bedeutet
- Eine verifizierte From-Domain
- Ein API-Schlüssel, der auf den richtigen Workspace beschränkt ist
- Strukturierter HTML- und Textinhalt
- Eine Retry-Strategie, die doppelte Zustellung vermeidet
Checkliste für die Implementierung
- Legen Sie eine verifizierte Domain an und wählen Sie eine Absenderadresse.
- Speichern Sie den API-Schlüssel in serverseitigen Umgebungsvariablen.
- Senden Sie eine Testnachricht an ein Postfach, das Sie kontrollieren.
- Protokollieren Sie die Antwort-ID des Providers und behandeln Sie fehlgeschlagene Antworten.
- Ergänzen Sie bei wiederholten Jobs einen Idempotenzschlüssel oder eine Event-ID.
Häufige Fragen von Teams
Darf ein API-Schlüssel im Browser-Code verwendet werden?
Nein. Bewahren Sie Zugangsdaten für den Versand auf einem Server, in einem Worker oder in einem vertrauenswürdigen Backend auf.
Wie vermeide ich doppelt versendete E-Mails?
Verwenden Sie eine stabile Event-ID oder einen Idempotenzschlüssel und speichern Sie die Message-ID des Providers, bevor Sie fehlgeschlagene Jobs wiederholen.