SMS Jobs löschen 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/delsms/UID
# oder:
https://www.sms4.de/restapi_delsms.php?uid=UID
einen SMS Auftrag loeschen den Sie mit der Http-XML Schnittstelle angelegt haben.
Verwenden Sie als uniquie ID (UID) die ID welche Sie beim Aufruf Http-XML Schnittstelle erhalten haben.

 

1.) Parameter

Parameter Beispiel Beschreibung
UID -unique job id(Pflicht) 7b8a00dcb358cb76ecf5b151eb7ef356 Die ID erhalten Sie beim Aufruf der XML http Schnittstelle

Die Unique ID des Auftrags erhalten Sie bei der Ãœbergabe der SMS über unsere http-XML Schnittstelle als Rückgabewert.

2.) Statuscodes

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

{
  "status": "OK",
  "count": 3,
  "detail": "3 SMS have been deleted"
}

Definierte Codes für das Feld status: 

 OK
 ERROR

3.) Fehlermeldungen

Wenn Sie eine ungültige uid eingeben oder eine uid die bereits gelöscht wurde, erhalten Sie folgende Fehlermeldung: 

{
  "status": "ERROR",
  "count": 0,
  "detail": "unknown uid"
}

Wenn die UID als Parameter fehlt erhalten Sie folgende Fehlermeldung: 

{
  "status": "ERROR",
  "count": 0,
  "detail": "parameter uid - unique id is missing"
}