Notify/notifications

From KWICK! Developer Wiki

Jump to: navigation, search

Contents

Beschreibung

Aufzurufende Url: /notifications/?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 Ereignisse (Benachrichtigungen) für den eingeloggten Benutzer. Der Platzhalter ?PAGE steht hierbei für die anzufragende Seite.

Parameter

Keine.

Rückgabe

Name Beschreibung
page Aktuell abgefragte Seite. Die erste Seite ist Seite 0, die zweite 1, und so weiter.
maxPage Die Maximale Seitennummer, falls es mehrere Seiten gibt. Bei 5 Seiten beispielsweise 4.
ticker_count Anzahl der Ereignisse.
ticker Ein JSON-Array, welches für jedes Ereignis ein JSON-Objekt mit folgenden Werten enthält.
Name Beschreibung
uid Mitglieds-ID des Ereignis-Auslösers.
uname Mitgliedsname des Auslösers
age Alter des Auslösers in Jahren.
sex Geschlecht des Auslösers. 1 für weiblich oder 2 für männlich.
ts Datum und Uhrzeit des Ereignisses als UNIX-Zeitschlüssel.
exp Ablaufdatum- und Uhrzeit des Ereignisses als UNIX-Zeitschlüssel.
message Name bzw. Beschreibung des Ereignisses.
city Ort des Auslösers.
vcard Visitenkarte (vcard) des Ereignis-Auslösers. Siehe User/username.

Fehler-Rückgabe

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

Personal tools