SMS Sendeberichte via API


 
  1. Parameter
  2. Statuscodes
  3. Fehlermeldungen

Sie können über die Eingabe folgender Adresse in Ihrem Browser, bzw. über einen automatischen Aufruf der URL per http oder https GET

https://www.sms4.de/restapi/v1/dlr/KUNDENNUMMER/SMSID
einen Sendebericht (DLR = Delivery Notififcation Reports) abrufen.

 

1.) Parameter für Sendeberichte

Parameter Beispiel Beschreibung
Kundennummer(Pflicht) XY12345 Ihre SMS4.de Kundennummer
SMS ID(Pflicht) 123456789 Referenz-Nummer der gesuchten SMS

Bitte Kundennummer und SMS ID mit Ihren Daten ersetzen.
Falls Sie noch keine Kundennummer haben, können Sie diese hier eine kostenlos beantragen.
Die SMS ID erhalten Sie bei der Übergabe der SMS über unsere http und http-XML Schnittstelle als Rückgabewert.

2.) Statuscodes

Der Aufruf der URL per GET-Methode liefert im Erfolgsfall Folgendes zurück:

{
  "smsId": "404xxxxx",
  "status": "0",
  "statusText": "OK",
  "mobile": "49175xxxxx",
  "dateTime": "2016-10-19 15:08:47",
  "statusDetailText": "Transfer OK - An das Telefon gesendet"
}

Definierte Codes für Feld status:

 0 = OK
 1 = Offen
 2 = Fehler

3.) Fehlermeldung

Wenn Sie eine ungültige Kombination von Kundennummer und SMS-Referenz-ID eingeben, erhalten Sie folgende Fehlermeldung:

{
    "error": "smsid not found"
}