Tovanix

E-Mail-Versand-API

Versenden Sie serverseitig über Ihre eigene Domain mit denselben Kontingenten, Abrechnungen und Limits wie beim E-Mail-Versand in der Konsole. Die Absenderdomain muss exakt einer verbundenen, aktiven Versanddomain entsprechen.

Authentifizierung: derselbe API-Schlüssel auf Nutzerebene wie für alle anderen offenen APIs der Plattform
Versand: POST /api/v1/mail/send; die Antwort ist nach Empfänger gegliedert. bounced_addrs ist die einzige Grundlage zur Bereinigung Ihrer Liste
Idempotenz: Mit dem Header Idempotency-Key führen wiederholte Anfragen mit demselben Schlüssel genau einen Versand aus, ohne doppelte Zustellung oder Abrechnung
Nachrichtenverläufe: Übergeben Sie in_reply_to und die vollständige references-Kette, damit Antworten im ursprünglichen Gespräch des Empfängers erscheinen
Kontingent und Domains: Fragen Sie das verbleibende Tageskontingent und nutzbare Versanddomains ab, um den Durchsatz in Ihrem System zu begrenzen
Codebeispiele: minimale, funktionsfähige Beispiele für cURL / Node.js / Python / Go / PHP, jeweils mit Idempotenz und Behandlung dauerhafter Zustellfehler

Häufig gestellte Fragen

Bedeutet HTTP 200, dass alle Empfänger die E-Mail erhalten haben?

Nein. Ergebnisse werden nach Empfänger aufgeteilt: Von fünf Empfängern können 2 beliefert, 1 eingereiht und 2 dauerhaft abgewiesen sein. Es gibt keinen Webhook für Zustellfehler; bounced_addrs ist daher die einzige Grundlage zur Listenbereinigung. Stellen Sie den Versand an diese Adressen sofort ein.

Wann ist ein Idempotency-Key erforderlich?

Immer, wenn ein Aufruf automatisch wiederholt werden kann: nach Zeitüberschreitungen, erneuter Jobzustellung oder durch SDK-Wiederholungen. Ohne ihn kann eine kurze Netzwerkstörung zwei E-Mails und eine doppelte Abrechnung verursachen. Beides lässt sich nicht rückgängig machen. Nutzen Sie einen Geschäftsschlüssel wie die Bestell-ID.

Wird geladen…