Erweiterung

Mail API

Transaktions-E-Mails über HTTP-APIs: Brevo, Mailgun, Mailjet, Maileroo, Postmark, Mailchimp, Resend, SendGrid, MailerSend, Scaleway.

• Kategorie: email
• Status: Verfügbar
• Version: 0.3.1
• Preis: Unbekannt
• Quelle: Offizielles Plugin-Register
• Installation: Sandbox-Plugin aus dem Register
• Geprüft: 2026-10-21

Link kopieren In Claude öffnen In ChatGPT öffnen

Auf X teilen Auf LinkedIn teilen Auf Reddit teilen

Beschreibung

Mail API macht die HTTP-API Ihres E-Mail-Anbieters zum E-Mail-Transport von EmDash. Anmeldelinks, Einladungen und Plugin-E-Mails gehen über Brevo, Mailgun, Postmark oder einen anderen Dienst hinaus, ohne SMTP-Server.

Funktionen

• 10 Anbieter: Brevo, Mailgun, Mailjet, Maileroo, Postmark, Mailchimp Transactional (Mandrill), Resend, SendGrid, MailerSend und Scaleway TEM.
• Verifizierte Absender: Wählen Sie eine von Ihrem Anbieter verifizierte Adresse oder Domain oder geben Sie eine ein.
• Kontostatus: Tarif, Guthaben, Kontingente und Reputation, aus der Anbieter-API gelesen.
• Fehler, mit denen Sie etwas anfangen können: die eigene Meldung des Anbieters, mit HTTP-Status, Fehlercode, Hinweis, Link zur Seite, die das Problem behebt, und der Rohantwort.
• Wiederholungswarteschlange: Wenn der Anbieter ausfällt oder die Rate begrenzt, wartet die E-Mail in einer verschlüsselten Warteschlange und wird mit wachsender Verzögerung erneut gesendet.
• Verlauf und Protokolle: jeder Versand mit Status, Nachrichten-ID, Versuchen und Dauer, mit Filtern, Erneut senden, einem 14-Tage-Diagramm und einem Dashboard-Widget.
• Testformular auf der Seite jedes Anbieters.
• Verschlüsselt: API-Schlüssel sind EmDash-Secrets, gespeicherte E-Mail-Inhalte sind verschlüsselt, und Anmelde-E-Mails werden nie gespeichert.
• Admin auf Englisch, Französisch und Deutsch, auf dem Smartphone nutzbar.

Anbieter

Anbieter	Zugangsdaten	Aufgelistete Absender	Kontostatus
Brevo	API-Schlüssel	Adressen	Tarif, Guthaben
Mailgun	API-Schlüssel, Domain, Region	Domain	Domainstatus
Mailjet	API-Schlüssel, geheimer Schlüssel	Adressen, Domains	Nein
Maileroo	Sendeschlüssel	Nein	Nein
Postmark	Server-Token	Nein	Server, Modus
Mailchimp Transactional	Mandrill-Schlüssel	Domains	Reputation, Kontingent
Resend	API-Schlüssel	Domains	Tarif, Kontingente
SendGrid	API-Schlüssel	Adressen, Domains	Tarif, Guthaben
MailerSend	API-Token	Adressen, Domains	API-Kontingent
Scaleway TEM	Geheimer Schlüssel, Projekt-ID	Domains	Angebot, Nutzung

Wo Absender nicht aufgelistet werden, geben Sie die Adresse ein.

Installation

Voraussetzungen

• EmDash 1.3.0 oder neuer mit einem Plugin-Sandbox-Runner: Cloudflare Worker Loader (Tarif Workers Paid) oder @emdash-cms/sandbox-workerd unter Node.js.
• EMDASH_ENCRYPTION_KEY auf der Website: Er verschlüsselt die API-Schlüssel. Erzeugen Sie einen mit npx emdash secrets generate und speichern Sie ihn unter Cloudflare mit wrangler secret put EMDASH_ENCRYPTION_KEY. Bewahren Sie eine Kopie in einem Secret-Manager auf: Ohne ihn ist ein Datenbank-Backup nutzlos.
• Ein Scheduler für die Wiederholungswarteschlange: unter Node.js integriert. Auf Cloudflare ein Cron-Trigger * * * * * und der scheduled-Handler (die EmDash-Vorlagen enthalten beides).
• Ein Konto und ein API-Schlüssel bei einem der unterstützten Anbieter.

Installieren

1. Installieren Sie Mail API aus der Plugin-Registry.
2. Prüfen Sie die Berechtigungen und bestätigen Sie: Anfragen nur an die API-Hosts der Anbieter und die Zustellung von EmDash-E-Mails.

Stattdessen über npm: pnpm add @devbitme/emdash-plugin-apimail, dann den Standardimport zu sandboxed: [...] in der emdash()-Integration von astro.config.mjs hinzufügen.

Einrichten

1. Öffnen Sie im Admin-Bereich Mail API und dann Configure bei Ihrem Anbieter.
2. Fügen Sie den oder die Schlüssel ein und speichern Sie. Der Abschnitt Account bestätigt, dass der Schlüssel funktioniert.
3. Wählen Sie unter Send a test email einen verifizierten Absender, geben Sie Ihre Adresse ein und senden Sie. Lassen Sie Use as the default sender aktiviert, um diesen Absender zu behalten.
4. Klicken Sie in der Liste auf der Karte des Anbieters auf Activate.
5. Sind mehrere E-Mail-Transporte installiert, wählen Sie unter Settings → Email den Eintrag Mail API. Unter astro dev zählt der Konsolen-Transport von EmDash als einer.

Einstellungen

Der Tab Queue & history legt fest, wie lange eine E-Mail in der Warteschlange warten darf (standardmäßig 15 Minuten für Anmelde-E-Mails, 24 Stunden für alle übrigen), ob E-Mail-Inhalte gespeichert werden und wie lange Verlauf und Protokolle aufbewahrt werden (standardmäßig 30 Tage).

Vollständige Dokumentation: https://git.devbit.me/devbit.me/emdash-plugin-apimail

FAQ

Brauche ich einen SMTP-Server?

Nein. Mail API ruft die HTTP-API des Anbieters über HTTPS auf und funktioniert daher auch dort, wo SMTP nicht verfügbar ist, etwa auf Cloudflare Workers.

„Send test email“ von EmDash meldet nur „Failed to send test email“.

Nutzen Sie das Formular Send a test email auf der Seite des Anbieters: Es zeigt die Meldung des Anbieters, einen Hinweis und die Rohantwort. Der Fehler steht auch unter Logs und im Server-Protokoll.

Die Absenderliste ist leer oder zeigt HTTP 401 oder 403.

Der Schlüssel kann senden, aber keine Absender auflisten. Resend braucht einen Full access-Schlüssel, SendGrid Lesezugriff auf Sender Authentication und User Account, MailerSend Domains und Sender identity, Scaleway TransactionalEmailReadOnly und Mailgun den Kontoschlüssel statt eines Domain-Sendeschlüssels. Sie können die Absenderadresse trotzdem eingeben.

Der Fehler besagt, dass die IP-Adresse nicht erlaubt ist.

Fügen Sie die ausgehende IP Ihres Hosts zur Zulassungsliste des Anbieters hinzu oder schalten Sie die Einschränkung ab. Der Fehler verlinkt auf die richtige Seite.

Was passiert, wenn der Anbieter ausfällt?

Netzwerkfehler, Zeitüberschreitungen, HTTP 429 und 5xx legen die E-Mail in eine verschlüsselte Warteschlange. Sie wird nach 1, 5, 15 und 30 Min., dann nach 1 Std., 2 Std. und danach alle 4 Std. über den zu diesem Zeitpunkt aktiven Anbieter erneut versucht. Anmelde-E-Mails verfallen nach 15 Minuten, andere E-Mails nach 24 Stunden. Dauerhafte Fehler, etwa ein ungültiger Schlüssel oder ein abgelehnter Empfänger, werden nicht wiederholt.

Die Warteschlange läuft nie.

Öffnen Sie den Tab Security von Mail API: Er listet die geplanten Aufgaben auf und hat eine Schaltfläche Repair. Prüfen Sie auf Cloudflare den Cron-Trigger und den scheduled-Handler.

Wird der Inhalt meiner E-Mails gespeichert?

Nur solange er in der Warteschlange wartet oder, wenn Sie Keep email content in the history aktivieren, im Verlauf. In beiden Fällen ist er verschlüsselt. Anmelde- und Einladungs-E-Mails werden nach dem Versand nie gespeichert.

Kann ich mehrere Anbieter verwenden?

Ja. Konfigurieren Sie mehrere und klicken Sie bei dem, der sendet, auf Activate. Aktivieren Sie bei einem Ausfall einen anderen: Eingereihte E-Mails werden darüber erneut gesendet.

Sicherheit

Eine Sicherheitslücke melden

Schreiben Sie an [email protected]. Bitte eröffnen Sie nicht zuerst ein öffentliches Issue.

Berechtigungen

• Netzwerkanfragen, beschränkt auf die API-Hosts der Anbieter: api.brevo.com, api.mailgun.net, api.eu.mailgun.net, api.mailjet.com, api.us.mailjet.com, smtp.maileroo.com, api.postmarkapp.com, mandrillapp.com, api.resend.com, api.sendgrid.com, api.eu.sendgrid.com, api.mailersend.com, api.scaleway.com.
• E-Mail-Transport: EmDash übergibt seine ausgehenden E-Mails an das Plugin, das sie über den aktiven Anbieter sendet.

Das Plugin läuft in der Sandbox von EmDash und kann nichts anderes erreichen.

API-Schlüssel

API-Schlüssel sind geheime EmDash-Einstellungen, mit AES-GCM unter dem EMDASH_ENCRYPTION_KEY der Website verschlüsselt. Ein gespeicherter Schlüssel geht nie zurück an den Browser: Der Admin-Bereich zeigt nur seine letzten 5 Zeichen. Jedes konfigurierte Secret, das ein Anbieter in einer Fehlermeldung zurückgibt, wird maskiert.

Gespeicherte Daten

• Verlauf: Empfänger, Betreff, Anbieter, Status, Nachrichten-ID, Versuche, Dauer und Fehler. Standardmäßig nach 30 Tagen gelöscht.
• E-Mail-Inhalt: nur gespeichert, solange die E-Mail in der Warteschlange wartet, oder im Verlauf, wenn Sie das aktivieren. Er wird mit AES-GCM unter einem zufälligen 256-Bit-Schlüssel verschlüsselt, der selbst als EmDash-Secret gespeichert ist. Anmelde- und Einladungs-E-Mails werden nach dem Versand nie gespeichert.
• Protokolle: Fehler, Warteschlangenläufe und Bereinigungen, zusammen mit dem Verlauf gelöscht.
• Verifizierte Absender und Kontostatus: im Plugin-Speicher mit einem Fingerabdruck der Einstellungen zwischengespeichert, nie ein Schlüssel.

E-Mails gehen nur an die API des aktiven Anbieters. Sonst verlässt nichts die Website.

Öffentliche Route

Eine Route ist öffentlich: GET /_emdash/api/plugins/apimail/logo?p=. Sie liefert die im Plugin gebündelten Anbieter-Logos aus und liest keine Daten.

Admin

Die Admin-Seiten nutzen eine private Route: Bevor das Plugin läuft, verlangt EmDash einen angemeldeten Benutzer mit der Berechtigung zur Plugin-Verwaltung und den CSRF-Header.

Änderungsprotokoll

0.3.1

• Drei Anbieterkarten pro Zeile statt zwei: eine kompaktere Liste auf dem Desktop.
• Ein Link Website auf jeder Anbieterkarte, der in einem neuen Tab geöffnet wird.
• Set as default heißt jetzt Activate, kurz genug für eine Karte auf dem Smartphone.
• Eine Anbieterseite öffnet sich sofort aus den gespeicherten Daten, mit Angabe von deren Alter. Der Anbieter wird nur aufgerufen, wenn ein Schlüssel gespeichert wird oder mit **Refresh from **, und eine Meldung nennt die Dauer des Aufrufs.

0.3.0

• Schaltfläche Set as default auf der Karte jedes konfigurierten Anbieters.
• Ein fehlgeschlagenes Lesen der verifizierten Absender oder des Kontostatus wird in die Protokolle geschrieben und beim nächsten Laden der Seite wiederholt, außer wenn dem Schlüssel die Berechtigung fehlt.
• Die Absenderliste zeigt, wann sie gelesen wurde, auch nach einem Fehler.
• Admin-Seiten passen auf ein Smartphone: zwei Anbieterkarten pro Zeile, höchstens drei Statistikkarten, lange Werte in einer eigenen Zeile, weniger Verlaufsspalten.
• Kürzere Menüeinträge: History, Queue, Logs.
• Einfache Bindestriche statt langer Gedankenstriche in Beschriftungen, Protokollen, Fehlern und im Betreff der Test-E-Mail.
• Kleineres Paket: Die Anbieter-Logos sind verlustfreie WebP-Kacheln.
• Registry-Eintrag: Tabs für Beschreibung, Installation, FAQ, Änderungsprotokoll und Sicherheit sowie ein Banner.

0.2.0

• Auswahl eines verifizierten Absenders beim Anbieter: eine verifizierte Adresse, jede Adresse einer verifizierten Domain oder manuelle Eingabe. Im Tab Sender und in jedem Testformular.
• Kontostatus auf der Seite jedes Anbieters: Tarif, Guthaben, Kontingente und Reputation.
• Ein Test benötigt keinen konfigurierten Absender mehr, und Use as the default sender behält den, der funktioniert hat.
• Ein gespeicherter Schlüssel zeigt seine letzten 5 Zeichen.
• Deutscher Admin-Bereich.