1. Home
  2. Docs
  3. Gateway
  4. HTTP Api
  5. 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 und status für die Msg ID und den aktuellen Statusbericht angehängt.
Bitte beachten Sie, dass kein zweiter Aufruf erfolgt, sofern Ihr Server nicht erreichbar ist. 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

Statusberichte abfragen

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

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

ParameterBeschreibung
msg_idDie 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 UNIX- Zeitstempel ausgegeben.

Beispiel

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

Response:
DELIVERED
1396355161

Mögliche Statusberichte

StatusberichtBeschreibung
DELIVEREDDie SMS wurde erfolgreich zugestellt
NOTDELIVEREDSMS konnte nicht zugestellt werden. Bitte prüfen Sie ggf. die Empfängernummer
BUFFEREDSMS wurde erfolgreich verschickt, wurde aber durch das SMSC zwischengespeichert, da der Empfänger nicht erreichbar ist
TRANSMITTEDSMS wurde durch das SMSC verschickt und sollte demnächst ankommen
ACCEPTEDSMS wurde durch das SMSC akzeptiert
EXPIREDSMS wurde vor Ablauf der Gültigkeit nicht empfangen
REJECTEDSMS wurde durch den Carrier abgelehnt
FAILEDFehler beim Versand
UNKNOWNUnbekannter Statusbericht
Was this article helpful to you? Yes 1 No
Menü