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

https://www.sms4.de/restapi/v1/dlr/KUNDENNUMMER/SMSID1,SMSID2,SMSIDxxx
einen oder beliebig viele Sendeberichte (DLR = Delivery Notififcation Reports) abrufen.
Fü mehrere Sendeberichte die SMSIDs bitte mit Komma trennen.

 

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 bei einem Sendebericht: 

{
    "error": "smsid not found"
}
oder ein leeres Array im Falle mehrerer Sendeberichte: 
[ ]