Tovanix
Tovanix

SMTP-E-Mail-API

Eine Versand-API für Transaktions-E-Mails wie Registrierungsbestätigungen, Bestellbenachrichtigungen und Passwortzurücksetzungen, verfügbar über Standard-SMTP und eine HTTP-API.

  • Zwei Zugangswege: vorhandenen SMTP-Client ohne Codeänderungen weiterverwenden oder für detailliertere Zustellbelege zur HTTP-API wechseln
  • Vorlagen: zentral verwalten und beim Versand nur Variablen übergeben
  • Sammelversand: viele Empfänger je Aufruf, mit eigenem Zustellbeleg je Empfänger
  • Zustellungs- und Rückläufer-Webhooks: Echtzeitereignisse für Zustellung, Rückläufer und Beschwerden zum Schutz der Absenderreputation

POST / GET /api/v1/smtp/*

Übersicht

Die SMTP-Aggregations-API ermöglicht E-Mail-Versand. Fügen Sie Ihre SMTP-Konten hinzu und senden Sie über eine einheitliche API. Unterstützt intelligente Rotation mehrerer Konten, automatischen Ausfallschutz und Kontingentverwaltung.

Abonnement kaufen -> SMTP-Konten hinzufügen -> API-Schlüssel erstellen -> Versand-API aufrufen

Authentifizierung

SMTP-API verwendet modulspezifische Schlüssel mit Präfix smk_. Zwei Authentifizierungsmethoden:

Nutzerkonsole öffnen -> SMTP-Aggregations-API -> API-Schlüsselverwaltung. Schlüssel sofort nach Erstellung speichern; nach Schließen kann er nicht vollständig erneut angezeigt werden.

E-Mail senden

POST /api/v1/smtp/send

E-Mail senden. Das System wählt das optimale SMTP-Konto anhand von Priorität, Nutzung und Zustand.

Antwortfelder

Senden Sie für sichere Wiederholungen einen Idempotency-Key-Header: Das erste erfolgreiche Ergebnis wird zwischengespeichert. Weitere Anfragen mit demselben Schlüssel liefern das ursprüngliche Ergebnis, ohne erneut zu senden oder das Kontingent doppelt zu belasten.

Antwort bei geplantem Versand

Bei einem zukünftigen send_at wird die E-Mail nicht sofort versendet. Stattdessen wird ein geplanter Auftrag angelegt und die folgende Struktur zurückgegeben (das Kontingent wird beim tatsächlichen Versand belastet):

Bei Überschreitung des Tages- oder Monatslimits wird code: 429 zurückgegeben. Wechseln Sie zu einem höheren Tarif oder warten Sie auf die Rücksetzung des Kontingents.

Gesammelt senden

POST /api/v1/smtp/send/batch

Antwortfelder

Die Empfängerobergrenze je Anfrage entspricht max_batch_size Ihres Tarifs (standardmäßig 10); bei Überschreitung schlägt die Anfrage sofort fehl. Tages- und Monatskontingente werden je E-Mail belastet, nicht je Anfrage; Empfänger auf der Abmeldeliste werden als fehlgeschlagen markiert. Große Stapel dauern länger, und die Anfrage kann vor der Antwort ablaufen: Senden Sie einen Idempotency-Key-Header; ein erneuter Versuch mit demselben Wert liefert das erste Ergebnis, statt den ganzen Stapel erneut zu senden.

Mit Vorlage senden

POST /api/v1/smtp/send/template

Antwortfelder

Der Vorlagenversand unterstützt dauerhafte Idempotenz: Fügen Sie den Anfrage-Header Idempotency-Key: <unique-string> hinzu. Der Sendeauftrag wird anhand von (Benutzer + API-Schlüssel + Schlüssel) dauerhaft gespeichert und bleibt bei Prozessneustarts oder Redis-Verlust erhalten. Regeln: (1) Eine Wiederholung mit demselben Schlüssel und Inhalt liefert das ursprüngliche Ergebnis, ohne erneut zuzustellen oder das Kontingent zu belasten; (2) derselbe Schlüssel mit anderem Inhalt führt zu einem 409-Konflikt — verwenden Sie einen neuen Schlüssel; (3) solange die erste Anfrage noch verarbeitet wird (pending), führt eine Wiederholung zu 409 — versuchen Sie es später mit demselben Schlüssel erneut; (4) ein fehlgeschlagener Auftrag kann nicht wieder geöffnet werden und liefert 409 — beginnen Sie mit einem neuen Schlüssel. Ohne diesen Header ist die Idempotenz deaktiviert (normaler Versand).

Kontingent abfragen

GET /api/v1/smtp/quota

Verbleibendes Versandkontingent des aktuellen Abonnements abfragen.

Versandstatus abfragen

GET /api/v1/smtp/status/:message_id

Versandstatus über die vom Versand-API zurückgegebene message_id abfragen.

Bericht zu Rückläufern/Beschwerden

POST /api/v1/smtp/inbound

Eine Unzustellbarkeit oder Beschwerde melden: Die Adresse wird automatisch in die Sperrliste aufgenommen und das zugehörige Versandprotokoll markiert. Künftige Sendungen überspringen sie, um Ihren Absenderruf zu schützen. Geben Sie mindestens email oder message_id an.

Häufig gestellte Fragen

Wir verwenden bereits SMTP. Müssen wir etwas umschreiben?

Nein. Tragen Sie im vorhandenen SMTP-Client Host, Port und Zugangsdaten von Tovanix ein. Wechseln Sie nur dann zur HTTP-API, wenn Sie detailliertere Belege für Zustellung und Rückläufer benötigen.

Wie sollen Rückläufer und Beschwerden behandelt werden?

Beides wird über Webhooks in Echtzeit gemeldet. Nehmen Sie die Adresse in Ihre Sperrliste auf und stellen Sie den Versand an sie sofort ein. Das schützt Ihre Absenderdomain vor Spam-Einstufungen.

Verwandte Seiten: SMTP-Aggregations-API · API-Dokumentation · SMS-Verifizierung

Wird geladen…