Mail/email/write/contactsel

From KWICK! Developer Wiki

Jump to: navigation, search

Contents

Beschreibung

Aufzurufende Url: /email/write/contactsel/GROUP/?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 Kontakte aus einer bestimmten Kontaktgruppe. Der Platzhalter GROUP steht hierbei für die Gruppen-ID der Kontaktgruppe, sowie der Platzhalter ?PAGE für die angefragte Seite.

Wird GROUP nicht angegeben, so werden alle Kontakte geliefert. Wenn ?PAGE nicht angegeben ist, wird die erste Seite angefragt.

Parameter

Keine.

Rückgabe

Name Beschreibung
buddiesSel Ein JSON-Array, welches für jeden Kontakt in der aktuellen Abfrage, also in der angegebenen Gruppe und auf der angefragten Seite, ein JSON-Objekt mit folgenden Werten enthält.
Name Beschreibung
userid Eindeutige Mitglieds-ID des Kontaktes.
username Mitglieds-Name.
groupid Gruppen-ID der Gruppe, in der sich der Kontakt befindet.
sex Geschlecht, 1 für weiblich oder 2 für männlich.
age Alter des Kontaktes in Jahren.
firstname Vorname des Kontaktes.
lastname Nachname des Kontaktes.
has_pic Wenn kein Bild vorhanden ist 0, wenn das Bild gesperrt ist -1, andernfalls der UNIX-Zeitstempel des aktuellen Mitgliedsbildes.

Fehler-Rückgabe

Im Fall einer Anfrage an eine Gruppe die nicht existiert, wird die Standardgruppe zurückgegeben. Des Weiteren ist darauf zu achten, dass die gewünschte Seitenzahl wirklich existiert, da andernfalls ein leeres Ergebnis zurückgegeben wird.

Personal tools