Schnittstellen

MMS per XML Schnittstelle

Es ist möglich MMS durch senden einer XML-POST-Anfrage zu senden.

API

Anfrage

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18 		<?xml version="1.0"?>
<MMS>
   <user>Username</user>
   <password>MD5 des Userpassworts</password>
   <timestamp>0</timestamp>
   <from>1</from>
   <to>+49(160)123456</to>
   <slides>
       <slide wait="0">
           <data typ="txt">BASE64TEXT</data>
           <data typ="img" ext="jpg">BASE64BILD</data>
           <data typ="snd" ext="mid">BASE64TON</data>
       </slide>
   </slides>
   <action>info</action>
   <return>html</return>
   <httphead>1</httphead>
</MMS>

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

Parameter Typ Beschreibung Standard
user Text Username  
password Text MD5-Hashwert des Passworts  
timestamp Zahl UNIX-Timestamp der genünschten Sendezeit. Bei 0 oder einem vergangenem Zeitpunkt wird sofort gesendet. 0
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.  
slides Node

Slides enthält als Unterpunkte die Folien. Jede Folie besteht aus einem Rahmen slide, welcher das Attribut wait beinhalten kann, und ein bis drei Datenobjekten <data typ="img" ext="jpg">BASE64BILD</data>. Jedes Datenobjekt muss das Attribut typ mit img, txt oder snd und das Attribut ext mit der Dateiendung bereitstellen. Der Dateiinhalt wird dann BASE64-kodiert als Inhalt eingefügt. Erlaubte Dateiformate:

  • jpg
  • gif
  • mid/midi
  
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).

Liste der Antwortcodes

Quellcodebeispiele

PHP

Beispiel: Versendet zwei Folien mit Text und gibt den Antwortquellcode aus.