Der Weg einer Nachricht
Nach dem Senden wird jeder Empfänger in die Warteschlange gestellt und berechnet und dann an eine Netzbetreiber-Route übergeben (gesendet). Der Netzbetreiber meldet später, ob das Telefon die Nachricht empfangen hat (zugestellt) oder nicht (fehlgeschlagen).
Wann Berichte eintreffen
Die meisten Berichte treffen innerhalb von Sekunden bis wenigen Minuten ein. Manche Netzbetreiber melden verspätet oder gar nicht; eine Nachricht ohne Bericht bleibt im Status gesendet.
Erstattungen
Eine fehlgeschlagene Nachricht wird automatisch Ihrem Guthaben erstattet. Jede Erstattung sehen Sie in Ihrem Guthabenverlauf, zusammen mit der Nachrichten-ID.
Webhooks empfangen
Hinterlegen Sie auf der Seite für API-Schlüssel eine https-Adresse. Wenn eine Nachricht zugestellt wird oder fehlschlägt, senden wir per POST einen JSON-Body mit Nachrichten-ID, Nummer, Status, Preis und Ihrer ref. Antworten Sie mit einem beliebigen 2xx-Status; andernfalls versuchen wir es innerhalb von etwa zwei Stunden bis zu 8 Mal erneut.
Die Signatur prüfen
Jeder Webhook enthält X-PortSMS-Signature: t=<time>,v1=<hex>. Berechnen Sie HMAC-SHA256 über den Text t.body mit Ihrem Signaturgeheimnis und vergleichen Sie das Ergebnis mit v1. Lehnen Sie Anfragen ab, die älter als fünf Minuten sind, damit eine alte Anfrage nicht erneut abgespielt werden kann.
