Schnittstellen

Adressbuch per Schnittstelle abfragen

API

Anfrage

Adresse: http://www.sloono.de/API/httpkonto.php?section=adress

Parameter Typ Beschreibung Standard
user Text Username  
password Text MD5-Hashwert des Passworts  
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 gespeicherten Adressen 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=adress&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 		<?xml version="1.0" encoding="iso-8859-1" ?>
    <answer>
        <code>101</code>
        <codetext>Erfolgreiche Abfrage</codetext>
        <info>
            <ADR0>
                <Vorname>Miguel</Vorname>
                <Nachname>Bastl</Nachname>
                <eMail>info@sloono.de</eMail>
                <Handynummer>+49(xxx)xxxxxxxx</Handynummer>
                <Spitzname>Chef</Spitzname>
                <Bemerkung></Bemerkung>
            </ADR0>
            <ADR1>
                <Vorname>Stephan</Vorname>
                <Nachname>Schweig</Nachname>
                <eMail>info@sloono.de</eMail>
                <Handynummer>+49(xxx)xxxxxxxx</Handynummer>
                <Spitzname>Me</Spitzname>
                <Bemerkung>Coder</Bemerkung>
            </ADR1>
        </info>
    </answer>
Die Handynummern und meine eMail-Adresse wurden aus SPAM-Schutzgründen entfernt, normalerweise werden sie aber so wie im Adressbuch angezeigt.