ToonTown-Click Image Hosting :: API Documentation

API Documentation

Um unsere API nutzen zu können erstellen Sie sich bitte ein API-Key im UserCP.

Sie können immer nur Ihre eigenen informatsionen oder die vom Eingeloggten User abrufen.

Die ausgaben unserer API erfolgt in XML mit kodienierung UTF-8.

Basis parameter in der API-URL:

Die Basis parameter können per GET oder POST Metode gesendet werden.

apikey; (den API-Key den Sie im UserCP erhalten haben)
version; (optional parameter, geben Sie die API Version (1.0.0) an damit bei änderungen Ihre Software trotzdem Funktioniert)
SID; (optional parameter, SennsionID wird beim login eines Users übergeben und mus an URL angehängt werden)

Bild auf dem Server laden:

Sende Array zu URL http://img.toontown-click.de/api.php per GET oder POST Metode:

action=upload; (Aktion Hochladen)
gast; (optional parameter, um das Bild als Gast online zu stellen, Achtung: dadurch verliehren sie die Rechte an diesem Bild)
localdatei; (optional parameter, Bilddatei)
remotedatei; (optional parameter, Bildlink)
hosting_tage; (optional parameter, Spaicherdauer in Tagen, 0 = Unbegrenzt)
beschreibung; (optional parameter, Bild Beschreibung)
set_size; (optional parameter, Bild neue Größe in PX, array("breite" => 100, "hoehe" => 100,"stretch" => false))
set_effekte; (optional parameter, Bild Effekte: gray_scale, mittelwertentfernung,...)
set_drehen; (optional parameter, angabe in Prozent: 90, 180, 270)
set_spiegeln; (optional parameter, vertikal oder horizontal)
set_format; (optional parameter, Bild Format, jpg,png oder gif)
thumb_infobar; (optional parameter, 0 = Infobar nicht Anzeigen, 1 = Infobar Anzeigen)
email; (optional parameter als Gast, E-Mail Adresse)
options[tags]; (optional parameter wenn MIHS Galerie installiert ist, Bild Tags mit Komma getrennt)
options[kid]; (optional parameter wenn MIHS Galerie installiert ist, Bilder Galerie ID, -1 Bild ist nicht ?fentlich)

Beispiel:
http://img.toontown-click.de/api.php?aktion=upload&remotedatei=[BILDLINK]

Ergebnis erfolgreich:

PHP Code:



<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>
        <codeid>a123aefcv</codeid>
</ergebnis>

Bild infos holen:

Sende Array zu URL http://img.toontown-click.de/api.php per GET oder POST Metode:

action=display; (Aktion Bild abrufen)
codeid; (Bild Code ID)

Beispiel:
http://img.toontown-click.de/api.php?aktion=display&codeid=[CODEID]

Ergebnis erfolgreich:

PHP Code:



<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>
    <images>
        <iid>457</iid>
        <codeid>i457b22ax2</codeid>
        <mid>0</mid>
        <mitglied/>
        <email/>
        <upload_name>/2012/03/i457b22ax2.png</upload_name>
        <basename>dgfdgfdgf.png</basename>
        <beschreibung/>
        <upload_datum>25.03.2012</upload_datum>
        <loesch_datum>30.03.2012</loesch_datum>
        <loesch_time>1333114091</loesch_time>
        <aufrufe>0</aufrufe>
        <traffic>0 Byte</traffic>
        <bewertung>0</bewertung>
        <stimmen>0</stimmen>
        <kommentare>0</kommentare>
        <hoehe>653</hoehe>
        <breite>932</breite>
        <mime><image/png</mime>
        <extension>png</extension>
        <size>83.78 KB</size>
        <thumb_infobar>1</thumb_infobar>
        <ip_adresse>78.42.101.17</ip_adresse>
        <status>1</status>
        <loesche_code>f6297</loesche_code>
        <images_path>http://domain.de/images-i457b22ax2.png</images_path>
        <thumb_path>http://domain.de/uploads/2012/03/thumb/i457b22ax2.png</thumb_path>
        <ihsthumb_path>http://domain.de/uploads/2012/03/ihsthumb/i457b22ax2.png</ihsthumb_path>
        <imagescodes>....</imagescodes>
        <kommentar_abgeben>1</kommentar_abgeben>
        <bewertung_abgeben>1</bewertung_abgeben>
        <kid>0</kid>
        <tags/>
    </images>
</ergebnis>

Bild vom Server löschen:

Sende Array zu URL domain.de/api.php per GET oder POST Metode:

action=loesche_images; (Aktion Löschen)
codeid; (Bild Code ID)

Beispiel:
http://img.toontown-click.de/api.php?aktion=loesche_images&codeid=[CODE]

Ergebnis erfolgreich eingeloggt:

PHP Code:



<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>true</ergebnis>

Upload Informatsionen abrufen:

Sende Array zu URL http://img.toontown-click.de/api.php per GET oder POST Metode:

action=uploadinfos; (Aktion Infos abrufen)

Beispiel:
http://img.toontown-click.de/api.php?aktion=uploadinfos

Ergebnis erfolgreich:

PHP Code:



<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>
<ergebnis>
        <mihs>
                <images_supported>jpg, jpeg, gif, png, bmp, psd</images_supported>
                <bildergroesse>2.00 MB</bildergroesse>
                <uploadgroesse>16.00 MB</uploadgroesse>
                <localupload>1</localupload>
                <remoteupload>1</remoteupload>
                <multiupload>0</multiupload>
                <speicherdauer>Unbegrenzt</speicherdauer>
                <wasserzeichen>an</wasserzeichen>
                <images_effekte>gray_scale</images_effekte>
                <images_effekte>negativ</images_effekte>
                <images_effekte>rot_faerben</images_effekte>
                <images_effekte>gruen_faerben</images_effekte>
                <images_effekte>blau_faerben</images_effekte>
                <images_effekte>relief</images_effekte>
                <images_effekte>mittelwertentfernung</images_effekte>
                <images_effekte>weichzeichnen</images_effekte>
                <images_effekte>pixelate</images_effekte>
        </mihs>
        <speicherdauer><name>1</name><value>1 Tag</value><default></default></speicherdauer>
        <speicherdauer><name>30</name><value>1 Monat</value><default></default></speicherdauer>
        <speicherdauer><name>365</name><value>1 Jahr</value><default>1</default></speicherdauer>
        <speicherdauer><name>0</name><value>Unbegrenzt</value><default></default></speicherdauer>
</ergebnis>

Profil Informatsionen abrufen:

Sende Array zu URL http://img.toontown-click.de/api.php per GET oder POST Metode:

action=profil; (Aktion Profil)
format; (0 = Profil wie aus der Datenbank, 1=Profil fertig Formatieren)

Beispiel:
http://img.toontown-click.de/api.php?aktion=profil&format=0

Ergebnis erfolgreich:

PHP Code:



<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>
    <profil>
        <mid>1</mid>
        <gid>4</gid>
        <show_gid>4</show_gid>
        <hid>3</hid>
        <benutzername>MatPo</benutzername>
        <email>email@domain.de</email>
        <kennwort>1235ffd7bd0732d7955c99cf43687f</kennwort>
        <avatar>avatar_1_01_11_2011.jpg</avatar>
        <beitraege>123</beitraege>
        <bilder>123</bilder>
        <webspace>123456789</webspace>
        <registriert>125631232</registriert>
        <letzter_login>1332684272</letzter_login>
        <ip_adresse>123.123.123.123</ip_adresse>
        <icq></icq>
        <show_email>1</show_email>
        <msn/>
        <language/>
        <yahoo/>
        <design/>
        <aim/>
        <zeitzone>0</zeitzone>
        <skype/>
        <webseite>http://www.matpo.de</webseite>
        <pn_benachrichtigen>1</pn_benachrichtigen>
        <bildkommentar_benachrichtigen>1</bildkommentar_benachrichtigen>
        <geburtstag>27.06.1985</geburtstag>
        <newsletter>1</newsletter>
        <wohnort/>
        <signatur/>
        <geschlecht>keine_angabe</geschlecht>
    </profil>
</ergebnis>

User Einlogggen:

Sende Array zu URL http://img.toontown-click.de/api.php per GET oder POST Metode:

action=login; (Aktion Login)
benutzername; (Ihr Benutzername)
kennwort; (Ihr Kennwort)

Beispiel:
http://img.toontown-click.de/api.php?aktion=login&benutzername=[BENUTZERNAME]&kennwort=[KENNWORT]

Ergebnis erfolgreich eingeloggt:

PHP Code:



<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>
        <login>123</login>
        <mid>123</mid>
        <email>meine@email.de</email>
        <sid>PHPSID=abcdefg1234567</sid>
</ergebnis>

Ausgabe von Errors:

Wenn ein Fehler entstanden ist gibt die API die Fehler mit Fehlercode und Fehlertext aus:

PHP Code:



<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>
        <errors code="fehlercode">Fehlertext</errors>
        <errors code="fehlercode">Fehlertext</errors>
</ergebnis>

API Beispiel Downloads

PHP Beispiel Downloaden