Sende-API-Dokumentation

Eine API für Anmelde-, Passwort-Reset- und Benachrichtigungs-E-Mails von Ihrer Website – ohne SMTP.

API-Schlüssel holen

Jetzt verfügbar Eigentum, MX, SPF, DKIM und DMARC werden separat geprüft. Danach mit einem API-Schlüssel senden und im Dashboard je Empfänger zugestellt/fehlgeschlagen/ausstehend verfolgen.

Schnellstart

  1. 1

    Domain einbinden

    Fügen Sie Ihre Sende-Domain unter Website-Versand hinzu.

  2. 2

    DNS prüfen

    Fügen Sie SPF / DKIM / DMARC und den Verifizierungs-TXT-Eintrag hinzu und prüfen Sie per Klick.

  3. 3

    Schlüssel erstellen

    Erstellen Sie einen te_live_-Schlüssel – der Klartext wird nur einmal gezeigt, also sofort speichern.

E-Mail senden

Eine POST-Anfrage mit Ihrem te_live_-Schlüssel im Authorization-Header.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Anfragefelder

from Absenderadresse, muss zu einer verifizierten Domain gehören
to Empfängeradresse (einzeln oder Array)
subject E-Mail-Betreff
html / text E-Mail-Text (HTML oder Klartext)
Idempotency-Key Optionaler Header; bei Wiederholungen denselben Wert nutzen, um Doppelsendungen zu vermeiden

Eine akzeptierte Anfrage liefert HTTP 202 mit id und Status accepted. Mit demselben API-Schlüssel liefert GET /api/sending/messages/{id} je Empfänger: zugestellt, fehlgeschlagen, ausstehend oder unbekannt.

Fehler & Limits

401 Ungültiger oder widerrufener Schlüssel – neuen te_live_-Schlüssel erzeugen
403 Absenderdomain nicht verifiziert oder Adresse nicht unter verifizierter Domain
429 Senderate überschritten; Antwort enthält retry_after – später wie angegeben erneut versuchen
503 Mail-Engine vorübergehend nicht verfügbar; mit derselben Idempotency-Key erneut versuchen

Empfängerzahl, Textgröße und Rate haben Schutzgrenzen. Verbrauch zählt erst nach Validierung, sodass ungültige Anfragen Ihr Kontingent nicht verbrauchen.

Bereit zur Integration?

API-Schlüssel holen FAQ ansehen