Schnittstellen

Kontostand per Schnittstelle abfragen

Es können jetzt Informationen zum Konto wie Kontostand, Anzahl der Nachrichten im Postausgang und Anzahl der Nahcrichten im Archiv ausgelesen werden.

API

Anfrage

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

Parameter Typ Beschreibung Standard
user Text Username  
password Text MD5-Hashwert des Passworts  
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 Kontodaten im Infobereich der Antwort zurückgegeben.

Zeile Inhalt
Kontostand: Kontostand als Text.
SMS: Anzahl der gesendeten Nachrichten insgesammt.
Postausgang: Anzahl der Nachrichten, die sich im Postausgang befinden.
Archiv: Anzahl der Nachrichten, die sich im Archiv befinden.

Beispiele

So kann eine GET-Anfrage aussehen:

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

So kann eine Textantwort aussehen:

1
2
3
4
5
6
7
 101
Erfolgreiche Abfrage

Kontostand: 4,578
SMS: 1234
Postausgang: 0
Archiv: 20

Quellcodebeispiele

PHP

Beispiel 1:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24 		<?php
 function Kontoinformationen($User,$Password) {
    if(strlen($User) == 0) return false;
    if(strlen($Password) == 0) return false;
    $url = "http://www.sloono.de/API/httpkonto.php?user=".urlencode($User);
    $url .= "&password=".md5($Password)."&httphead=0";
    $Antwort = @file($url);
    if($Antwort == false) return false;
    if(trim($Antwort[0]) != 101) return false;
    return array("Kontostand" => substr($Antwort[3],12),
        "Gesendet" => substr($Antwort[4],5),
        "Postausgang" => substr($Antwort[5],13),
        "Archiv" => substr($Antwort[6],8));
}
?>

<?php
$sloonoapi = Kontoinformationen("Max","PW von Max");
if($sloonoapi == false)
    echo "Fehler!";
else {
    foreach( as => ) echo .": ".."<br> ";
}
?>