1. Home
  2. Gateway
  3. HTTP Api
  4. Statusberichte

Statusberichte

Um Statusberichte zu erhalten bieten sich Ihnen grundsätzlich zwei Möglichkeiten: Die wesentlich effizientere und schnellere Methode ist ein Callback direkt an Ihren Server. Sobald ein neuer Status vorhanden ist, wird automatisch Ihre gewünschte URL aufgerufen. Die alternative Methode ist es, über einen Request an die Api direkt den Status einer SMS abfragen. Sollte noch kein Status vorhanden sein, müssten Sie ggf. später erneut anfragen. Bitte verwenden Sie am besten die Callbackvariante. Beide Varianten lassen sich auch kombinieren, z.B. falls der Callback fehlgeschlagen ist.

Statusberichte per Callback

Alternativ zur manuellen Abfrage können Sie in Ihrem Login unter Account > Einstellungen > HTTP API eine URL einstellen, zu der unser Server automatisch einen HTTP GET Request sendet, sobald ein neuer Status verfügbar ist. Um Ressourcen zu schonen und damit Sie möglichst schnell den aktuellen Status erhalten ist diese Methode der manuellen Abfrage vorzuziehen.

An Ihre URL, welche auch per SSL aufgerufen werden kann, werden dann die GET-Parameter msg_id, status und timestamp für die Msg ID, den aktuellen Statusbericht und den Zeitpunkt des Statusberichts angehängt.
Sollten wir Ihre Callback URL nicht erreichen konnten (Timeout oder HTTP Code 500), versuchen wir es bis zu 6 mal im Stundentakt erneut. Sofern große Mengen an Statusberichten bei Ihnen anfallen, ist eine kumulierte minütliche Absendung der Statusberichte möglich. Senden Sie uns hierzu bitte eine Nachricht.

Beispiel

Haben Sie z.B. folgende URL als Status URL eingetragen
https://www.ihrserver.de/status.php

Dann senden wir den Request z.B. so an Ihren Server:
https://www.ihrserver.de/status.php?msg_id=1234567&status=DELIVERED&timestamp=2020-01-09+15%3A41%3A30.656

Statusberichte abfragen

Über folgendes Script können Sie manuell den Statusbericht einer SMS abfragen:

https://gateway.sms77.io/api/status

Parameter Beschreibung
msg_id Die Msg ID der SMS. Diese erhalten Sie z.B. automatisch beim SMS Versand über die Api.

Falls kein Fehler auftritt, wird im Mime Type text/plain zuerst der Status und nach einem Zeilenumbruch der Zeitpunkt, zu dem der Status aktualisiert wurde, als Zeitstempel mit dem Datum im Format YYYY-MM-DD und dem Zeitpunkt mit Millisekunden  ausgegeben.

Beispiel

Request:
https://gateway.sms77.io/api/status?p=api-key&msg_id=12345678900

Response:
DELIVERED
2020-01-09 15:41:30.656

Mögliche Statusberichte

Statusbericht Beschreibung
DELIVERED Die SMS wurde erfolgreich zugestellt
NOTDELIVERED SMS konnte nicht zugestellt werden. Bitte prüfen Sie ggf. die Empfängernummer
BUFFERED SMS wurde erfolgreich verschickt, wurde aber durch das SMSC zwischengespeichert, da der Empfänger nicht erreichbar ist
TRANSMITTED SMS wurde durch das SMSC verschickt und sollte demnächst ankommen
ACCEPTED SMS wurde durch das SMSC akzeptiert
EXPIRED SMS wurde vor Ablauf der Gültigkeit nicht empfangen
REJECTED SMS wurde durch den Carrier abgelehnt
FAILED Fehler beim Versand
UNKNOWN Unbekannter Statusbericht
Fandest du diesen Artikel hilfreich? Ja 3 Nein 1
Menü