Schnittstellen

SMS per XML

Es ist möglich SMS durch senden einer XML-POST-Anfrage zu senden. Die Variablen sind die gleichen wie bei der normalen SMS.

API

Anfrage

Adresse: http://www.sloono.de/API/xmlsms.php

Der XML-Block sieht dabei möglicherweise so aus:

1
2
3
4
5
6
7
8
9
10
11
12
13 		<?xml version="1.0"?>
<SMS>
   <user>Username</user>
   <password>MD5 des Userpassworts</password>
   <typ>0</typ>
   <timestamp>0</timestamp>
   <text><![CDATA[SMS-Text]]></text>
   <from>1</from>
   <to>+49(160)4863634</to>
   <action>info</action>
   <return>html</return>
   <httphead>1</httphead>
</SMS>

Der XML-Block muss als Variable XMLDATA übertragen werden.

Parameter Typ Beschreibung Standard
user Text Username  
password Text MD5-Hashwert des Passworts  
typ Zahl/Text

Welcher SMS-Typ soll gesendet werden:

  • 0 oder Discount
  • 1 oder Basic oder Lite
  • 2 oder Pro
  • 3 oder FLASH
Bei dieser Variable kann entweder die Nummer oder der Text verwendet werden. typ=0 und typ=Discount haben die gleiche Wirkung.		 0
timestamp Zahl UNIX-Timestamp der genünschten Sendezeit. Bei 0 oder einem vergangenem Zeitpunkt wird sofort gesendet. 0
text Text SMS-Text mit maximal 1600 Zeichen.  
from Zahl

Absenderkennung:

  1. Handynummer
  2. Absenderkennung 1
  3. Absenderkennung 2
  4. Absenderkennung 3
  5. Absenderkennung 4
 1
to Text Zielnummern getrennt durch Komma (,) und im nationalen oder internationalen Format (0123/456789 oder +49(123)456789). Es können auch die Spitznamen aus dem Adressbuch oder Vor- + Nachname aus dem Adressbuch benutzt werden.  
action Text Es können die Werte info oder send gesetzt werden. Der Wert send überträgt die SMS ins System von sloono, während info nur Informationen über die SMS wie z. B. Preis zurück gibt. Nach dem senden werden die gleichen Informationen zurück gegeben. send
return Text Mit dieser Variable wird das Antwortformat festgelegt. Mit text wird die Antwort als Mehrzeiliger Text zurückgegeben während xml ein XML-Schema liefert. text
httphead Zahl Wenn httphead auf 1 gesetzt wird, so werden bei Fehlern HTTP-Header ungleich 200 gesendet. Beim Wert 0 muss der Fehler aus der Antwort abgelesen werden. 1

Alle Variablen, die keinen Standartwert haben müssen gesetzt werden!

Antwort

Eine Vorauswahl wird bereits mit dem HTTP-Header der Antwort getroffen. Wenn etwas anderes als HTTP 1/1 200 OK als Antwort empfangen wird ist ein Fehler aufgetreten. Zurückgegeben wird ein Fehlercode, ein Fehlertext und Informationen (falls vorhanden).

Beispiele

So kann eine XML-POST-Anfrage aussehen:

POST /API/xmlsms.php HTTP/1.1
Host: www.sloono.de
Content-Type: application/x-www-form-urlencoded
Content-length: 540
Connection: close

XMLDATA=%3C%3Fxml+version%3D%221.0%22%3F%3E%0D%0A%3CSMS%3E%0D%0A%09%3Cuser%3EMax%3C%2Fuser%3E%0D%0A%09%3Cpassword%3E41a2bb1f0a4d8b14b876e2379bbabb4a%3C%2Fpassword%3E%0D%0A%09%3Ctyp%3E0%3C%2Ftyp%3E%0D%0A%09%3Ctimestamp%3E0%3C%2Ftimestamp%3E%0D%0A%09%3Ctext%3E%3C%21%5BCDATA%5BDies+ist+ein+SMS-Text.%5D%5D%3E%3C%2Ftext%3E%0D%0A%09%3Cfrom%3E1%3C%2Ffrom%3E%0D%0A%09%3Cto%3E0123%252F456789%3C%2Fto%3E%0D%0A%09%3Caction%3Einfo%3C%2Faction%3E%0D%0A%09%3Creturn%3Ehtml%3C%2Freturn%3E%0D%0A%09%3Chttphead%3E1%3C%2Fhttphead%3E%0D%0A%3C%2FSMS%3E%0D%0A

So kann eine Textantwort aussehen:

1
2
3
4
5
6
7
8
9
10
 100
SMS erfolgreich versendet

Text: Dieser Text wird gesendet.
Zeichen: 26
SMS: 1
Absenderkennung: +49(123)456789
Ziele: +49(321)987654
Kosten: 0,059
Versenden: Sofort

So kann eine XML-Antwort aussehen:

1
2
3
4
5
6
7
8
9
10
11
12
 <?xml version="1.0" encoding="iso-8859-1"?>
<answer>
<code>100</code>
<codetext>SMS erfolgreich versendet</codetext>
<info>Text: Dieser Text wird gesendet.
Zeichen: 26
SMS: 1
Absenderkennung: +49(123)456789
Ziele: +49(321)987654
Kosten: 0,059
Versenden: Sofort</info>
</answer>

Liste der Antwortcodes

Quellcodebeispiele

PHP

Beispiel