Schnittstellen

Postausgang & Archiv per Schnittstelle abfragen

API

Anfrage

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

Parameter Typ Beschreibung Standard
user Text Username  
password Text MD5-Hashwert des Passworts  
section Text

Gibt die gewünschte Liste an:

  • outbox - Postausgang
  • archiv - Archiv
 
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).

An sonsten werden die Nachrichten im Archiv/Postausgang im Infobereich der Antwort zurückgegeben.


Beispiele

So kann eine GET-Anfrage aussehen:

http://www.sloono.de/API/httpkonto.php?user=musteruser&password=e16b2ab8d12314bf4efbd6203906ea6c&section=archiv&return=xml

So kann eine XML-Antwort aussehen:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
 <?xml version="1.0" encoding="iso-8859-1" ?>
    <answer>
        <code>101</code>
        <codetext>Erfolgreiche Abfrage</codetext>
        <info>
            <MSG0>
                <Text>[Folien]</Text>
                <Ziel>+49(160)1234567</Ziel>
                <Preis>0.35</Preis>
                <Gesendet>21.09.2005 13:15</Gesendet>
                <Typ>MMS</Typ>
                <Versenden>Sofort</Versenden>
                <Code>100</Code>
                <Codetext>SMS/MMS wurde erfolgreich übermittelt.</Codetext>
            </MSG0>
            <MSG1>
                <Text>Hallo x y! Alles Gute zum Geburtstag!</Text>
                <Ziel>+49(171)987654</Ziel>
                <Preis>0.06</Preis>
                <Gesendet>17.10.2005 12:34</Gesendet>
                <Typ>WEBSMS Discount</Typ>
                <Versenden>Sofort</Versenden>
                <Code>100</Code>
                <Codetext>SMS/MMS wurde erfolgreich übermittelt.</Codetext>
            </MSG1>
            <MSG2>
                <Text>Dieser Text wird gesendet.</Text>
                <Ziel>+49(160)192837</Ziel>
                <Preis>0.085</Preis>
                <Gesendet>18.10.2005 20:21</Gesendet>
                <Typ>WEBSMS Pro</Typ>
                <Versenden>Sofort</Versenden>
                <Code>100</Code>
                <Codetext>SMS/MMS wurde erfolgreich übermittelt.</Codetext>
            </MSG2>
        </info>
    </answer>