Sicher erneut senden mit der SMS-API
Sie versenden SMS über unsere API und erhalten gelegentlich eine Zeitüberschreitung oder einen Netzwerkfehler? Dann wissen Sie nicht, ob die Nachricht bereits verschickt wurde. Versuchen Sie es erneut, erhält der Empfänger dieselbe SMS womöglich zweimal. Mit dem neuen Parameter idempotency_key in Version 2 der SMS-API kann das nicht mehr passieren.
Wie funktioniert es?
Geben Sie beim Versenden einen eindeutigen Wert in idempotency_key mit, zum Beispiel eine UUID, eine pro Nachricht. Senden Sie dieselbe Anfrage innerhalb von 24 Stunden mit demselben Key erneut, verschicken wir nichts. Sie erhalten einfach die ursprüngliche Antwort zurück, mit derselben msgid, derselben uuid und demselben Zeitpunkt. In diesem Fall enthält die Antwort zusätzlich den Header Idempotency-Repeat: true, damit Sie wissen, dass es sich um eine Wiederholung handelt.
Der Parameter ist optional. Geben Sie ihn nicht mit, ändert sich an Ihrer bestehenden Anbindung nichts.
Gut zu wissen
- Ein Key bleibt ab der ersten Anfrage 24 Stunden gültig. Danach gilt er als neu und die Nachricht wird erneut verschickt.
- Keys gelten pro Konto: Ein anderer Kunde kann denselben Wert verwenden, ohne dass es zu einem Konflikt kommt.
- Verwenden Sie denselben Key für eine andere Nachricht, mit einer anderen Nummer, einem anderen Text oder einem anderen Absender, lehnen wir die Anfrage mit Code 20 ab.
- Trifft eine Wiederholung ein, während die erste Anfrage noch verarbeitet wird, erhalten Sie Code 21. Versuchen Sie es dann etwas später erneut.
- Wurde eine Anfrage abgelehnt, zum Beispiel weil nicht genügend Credits vorhanden waren, speichern wir den Key nicht. Nach dem Aufladen versuchen Sie es einfach mit demselben Key erneut.
- Ein Key darf höchstens 255 Zeichen lang sein. Ist er länger, erhalten Sie Code 19.
Alle Details finden Sie in der API-Dokumentation beim Versenden einer Nachricht.
