Proxer API/v1/Notifications

Aus Proxer.Me - Wiki
Wechseln zu: Navigation, Suche

Diese Klasse beinhaltet alle Schnittstellen, die mit Daten zu tun haben, die normalerweise auf Proxer oben rechts bei den Notifications zu sehen sind, insbesondere News und Benachrichtigungen.


Get Count

FunktionsnameGet Count
BeschreibungDiese Funktion gibt die Anzahl an verschiedenen Notification-Kategorien zurück (kleine rote Zahlen auf Proxer). Die Ausgabedaten befinden sich in einem Array, wobei folgende Indices folgende Anzahlen enthalten:
  • 0 = Error (entspricht error-Wert des jsons)
  • 1 = Altes PN-System (deprecated)
  • 2 = Neues PN-System
  • 3 = Freundschaftsanfragen
  • 4 = News
  • 5 = Benachrichtigungen
Anfragelinkhttps://proxer.me/api/v1/notifications/count
ZugriffslevelLevel 0
Eingabeparameter
  • Keine
Ausgabeparameter
  • error: 0 oder 1. 0 wenn das Abrufen erfolgreich war. Ansonsten 1.
  • message : Eine Statusbeschreibung im Klartext.
  • code (optional): Zur besseren maschinellen Verarbeitung gibt es bei einem Fehler ein Fehler-Code.
  • data (optional): Im Falle einer Erfolgreichen Abfrage sind hier die Ausgabedaten enthalten
Codes
  • 3002: User nicht eingeloggt



Get News

FunktionsnameGet News
BeschreibungGibt die neuesten News aus.

Der Bildlink einer News setzt sich zusammen aus: cdn.proxer.me/news/[News-ID]_[Image-ID].png

Für Tumbnail: cdn.proxer.me/news/th/[News-ID]_[Image-ID].png

Link zum Forumspost der News: proxer.me/forum/[catid]/[mid]
Anfragelinkhttps://proxer.me/api/v1/notifications/news
ZugriffslevelLevel 0
EingabeparameterParameter (GET oder POST):
  • p (optional): Die zu ladende Seite, beginnend ab 0 (Auf Seite 0 befinden sich die neuesten News, nach hinten werden die News älter). Wenn nicht gegeben, so wird die erste Seite geladen.
  • limit (optional): Die Anzahl der zu ladenden News pro Seite. Default 15.
Ausgabeparameter
  • error: 0 oder 1. 0 wenn die Abfrage erfolgreich war, ansonsten 1.
  • message: Eine Statusbeschreibung im Klartext.
  • code (optional): Zur besseren maschinellen Verarbeitung gibt es bei einem Fehler ein Fehler-Code.
  • data (optional): Ein Array aus Objekten mit den Daten der News. Dabei enthält jedes Objekt folgende Daten:
    • nid: Die ID der News
    • time: Der Zeitpunkt der publizierung (Unix-Timestamp als Sekunden gespeichert)
    • mid: Die ID des entsprechenden Forumsbeitrags
    • description: Die Beschreibung der News
    • image_id: ID zum Bild.
    • image_style: CSS-Konforme Style-Elemente um die Positionierung des Bildes zu bestimmen.
    • subject: Der Titel des entsprechenden Forumsbeitrags
    • hits: Anzahl der Zugriffe auf den entsprechenden Forumsbeitrag
    • thread: mid
    • uid: User-ID des Erstellers des Forumsposts
    • uname: Benutzername des Autors
    • posts: Anzahl der Antworten/Kommentare auf die News
    • catid: Die ID der Kategorie, in der sich eine News befindet.
    • catname: Der Name der Kategorie.
Codes
  • 2001: Serverfehler bei der Abfrage.



Delete

FunktionsnameDelete
BeschreibungLöscht eine gegebene Notification
Anfragelinkhttps://proxer.me/api/v1/notifications/delete
ZugriffslevelLevel 1
EingabeparameterParameter (POST):
  • nid (optional): Die ID der zu löschenden Notification. Wenn weggelassen oder 0, so werden alle als gelesen markierten Benachrichtigungen gelöscht.
Ausgabeparameter
  • error: 0 oder 1. 0 wenn die Abfrage erfolgreich war, ansonsten 1.
  • message: Eine Statusbeschreibung im Klartext.
  • code (optional): Zur besseren maschinellen Verarbeitung gibt es bei einem Fehler ein Fehler-Code.
Codes
  • 3002: User nicht eingeloggt.