SLOONO.de-API Account: Adressbuch
Aus SLOONO.de-API
Inhaltsverzeichnis |
[Bearbeiten] API
[Bearbeiten] 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!
[Bearbeiten] 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.
[Bearbeiten] Beispiele
So kann eine GET-Anfrage aussehen:
http://www.sloono.de/API/httpkonto.php?user=musteruser&password=e16b2ab8d12314bf4efbd6203906ea6c§ion=adress&return=xml
So kann eine XML-Antwort aussehen:
<?xml version="1.0" encoding="iso-8859-1" ?><answer><code>101</code>
<codetext>Erfolgreiche Abfrage</codetext>
<info><ADR0><Vorname>Max</Vorname>
<Nachname>Mustermann</Nachname>
<eMail>xxxxxx@xxxxxx.de</eMail>
<Handynummer>+49(xxx)xxxxxxxx</Handynummer>
<Spitzname>Chef</Spitzname>
<Bemerkung></Bemerkung></ADR0><ADR1><Vorname>Moriz</Vorname>
<Nachname>Musterfrau</Nachname>
<eMail>xxxxxx@xxxxxx.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.
