Photo/username/photos

From KWICK! Developer Wiki

Jump to: navigation, search

Contents

Beschreibung

Aufzurufende Url: /USERNAME/photos/?PAGE

Hinweis: In der Url mit einem ? (Fragezeichen) gekennzeichnete Pfade sind optionale Parameter, welche nicht bei jedem Aufruf erforderlich sind. Beachte bitte, dass die Reihenfolge der Parameter in jedem Fall eingehalten werden muss.

Soll beispielswiese der zweite optionale Parameter verwendet werden, so muss der Erste zwangsläufig mit angegeben werden, damit die Reihenfolge erhalten bleibt.

Liefert die Fotos und Fotoablen eines Mitgliedes. Der Platzhalter USERNAME steht hierbei für den Mitgliedsnamen, für den die Fotos angefragt werden sollen. Mittels ?PAGE wird die anzufragende Seite angegeben. Zusätzlich kann der Parameter albumid angegeben werden, welcher für die Album-ID des Albums steht, das angefragt werden soll. Sollen albenübergreifend alle Bilder angezeigt werden, dann muss der Parameter nicht angegeben werden.

Parameter

Name Übergabe Beschreibung
albumid (optional) GET / POST Schränkt die Rückgabe auf Fotos eines bestimmten Albums ein

Rückgabe

Name Beschreibung
page Aktuell abgefragte Seite. Die erste Seite ist Seite 0, die zweite 1, und so weiter.
maxPage Die Maximale Seitennummer. Bei 5 Seiten beispielsweise 4.
pr_vcard Visitenkarte (vcard) des Mitgliedes dessen Fotos angefragt werden. Siehe User/username.
piccount Gesamtzahl der Bilder in allen Alben des Mitgliedes.
selected ID des momentan angezeigten Albums oder 0 wenn kein Album ausgewählt.
folders Ein JSON-Array, welches für jedes Album ein JSON-Objekt mit folgenden Werten enthält.
Name Beschreibung
title Name des Albums
pics Anzahl der vorhandenen Bilder.
display Anzeigetyp des Albums. 0 für privat oder 1 für öffentlich.
created Erstellungsdatum und Uhrzeit des Albums nach ISO 8601 im Format JJJJ-MM-TT hh:mm:ss.
albumid Eindeutige ID des Albums. Diese ID kann im Platzhalter ?ALBUMID zur anfrage eines einzelnen Albums verwendet werden.
description Beschreibung zu diesem Album.
system Art des Albums. 0 für eigenes Album oder 1 für Systemalbum.
toppic Absolute URL des Bildes, das als Album-Icon verwendet wird.
toppic_id Bild-ID des Bildes, das als Album-Icon verwendet wird.
photos Ein JSON-Array, welches für jedes Foto in der aktuellen Auswahl, also im ggf. angegebenen Album und auf der zurückgegebenen Seite, ein JSON-Objekt mit folgenden Werten enthält.
Name Beschreibung
id Eindeutige Foto-ID.
url Absolute URL zur Vorschau des Fotos.
albumid Album-ID des Albums, in dem sich das Foto befindet. Siehe albumid bei folders.
big* Absolute URL zum Großbild.
titel* Titel des Bildes.
albumname Name des Albums.
description* Beschreibung des Bildes.
visits* Anzahl der Aufrufe des Bildes.
comments* Anzahl der Kommentare die zu dem Bild geschrieben wurden.
last_comment Eindeutige Kommentar-ID des letzten Kommentars zum Bild.

Die mit einem * (Stern) gekennzeichneten Attribute existieren nur, wenn gezielt ein Album angefragt wird, also der Platzhalter ?ALBUMID mit einer Album-ID gefüllt wird.

profileName Mitgliedsname des Mitglieds, dem das Album gehört.
loopInAlbum "true", wenn ein bestimmtes Album angefragt wird, andernfalls null.

Fehler-Rückgabe

Es ist darauf zu achten, dass bei der Angabe des Platzhalters ?PAGE stets auf existierenden Seiten, also zwischen 0 und maxPage geblättert wird, da andernfalls ein leeres Ergebnis zurückgegeben wird.

Name Beschreibung
errorMsg Fehlermeldung, falls aufgrund der Privatsphäreneinstellungen nicht zugegriffen werden kann.
Personal tools