Wiederholungen und Duplikate

Netzwerke fallen aus. Eine Anfrage kann bei weneed.email ankommen und gespeichert werden, während die Antwort unterwegs verloren geht. Richtig wiederholt gibt es eine Nachricht, falsch wiederholt bekommt die Empfängerin oder der Empfänger zwei.

Die Regel

Mit demselben Key und demselben Inhalt wiederholen.

• API: denselben Idempotency-Key und exakt denselben Request-Body verwenden. Keys werden sieben Tage gemerkt. Ein Key mit anderem Inhalt wird abgelehnt.
• SMTP: X-Email-Idempotency-Key setzen. Ohne ihn ist jede Einlieferung neu, und eine verlorene letzte Antwort kann ein Duplikat erzeugen. Message-ID wird nicht zur Duplikaterkennung genutzt.

Einen Key wählen

Nehmen Sie eine ID, die das Ereignis schon hat: die Anmelde-ID, die Bestellnummer plus Nachrichtentyp, die ID der Passwort-Zurücksetzung. Speichern Sie sie mit dem Ereignis, damit auch eine Wiederholung nach einem Absturz dieselbe verwendet.

Unklare Antworten

Sie sehen	Bedeutung	Tun
202 / 250	✓Gespeichert und eingereiht	Nichts. Zustellung im Verlauf verfolgen.
Keine Antwort, Timeout, 503, SMTP 451	?Unklar, ob gespeichert	Mit demselben Key und Inhalt wiederholen
Dauerhafter Fehler (4xx API, SMTP 5xx)	✕Nicht gespeichert	Anfrage korrigieren; erneutes Senden ist sicher

weneed.email sendet nie selbst erneut, wenn ein empfangender Server unklar antwortet. Die Nachricht bleibt im Verlauf unbekannt, statt ein Duplikat zu riskieren.

Setzen Sie bei Einmalcodes expires_at, damit eine verspätete Nachricht nicht zugestellt wird, wenn sie nutzlos ist.