Erster Versand per API

Sie brauchen

• Ein Projekt mit verbundener Domain und freigegebener Absenderadresse.
• Einen API-Schlüssel für dieses Projekt. Er wird beim Erstellen einmal angezeigt; speichern Sie ihn sofort in Ihrem Secret-Manager. Das Erstellen verlangt Ihren zweiten Faktor.
• Die API-Basis-URL und die Stream-ID von der API-Seite des Projekts.

Senden

curl -sS "$WENEED_API_URL/v1/emails" \
  -H "Authorization: Bearer $WENEED_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: signup-7f3c2a91-welcome" \
  -d '{
    "stream_id": "IHRE-STREAM-ID",
    "from": { "email": "hallo@ihredomain.at", "name": "Ihre App" },
    "to": [ { "email": "person@example.com" } ],
    "subject": "Willkommen",
    "text": "Danke für Ihre Anmeldung."
  }'

Die Antwort ist 202 mit einer Nachrichten-ID. Die Nachricht ist damit gespeichert und eingereiht. Den Zustellstatus sehen Sie im Dashboard bei der Nachricht.

Der Idempotency-Key ist wichtig

Idempotency-Key ist Pflicht: 16 bis 128 druckbare Zeichen, die genau diese eine Absicht benennen, etwa die ID des Anmeldeereignisses. Bricht die Anfrage ab, senden Sie sie erneut mit demselben Key und demselben Inhalt. Sie erhalten die ursprüngliche Nachricht statt eines Duplikats.

Erzeugen Sie für einen Wiederholungsversuch nie einen neuen Key. Siehe Wiederholungen und Duplikate.

Optionale Felder

Feld	Zweck
html	HTML-Inhalt. Senden Sie text, html oder beides.
reply_to	Eine Antwortadresse. Eine Domain-Verifizierung legt kein Postfach an; nutzen Sie ein bestehendes.
expires_at	Nach diesem Zeitpunkt nicht mehr senden. Sinnvoll für Einmalcodes.
tags	Bis zu 10 Schlüssel-Wert-Paare für Ihre eigene Filterung.

Alle Endpunkte und Antwortcodes stehen in der API-Referenz.