🪄 Levels

Mitglieder Liste

Die Mitgliederliste mit Filtern - die Grundlage jeder Massenaktion.

─── Warum die Filter hier und nicht erst bei der Sammelaktion ──────────

Weil man sehen muss, wen man trifft, BEVOR man etwas tut. Die Sammelaktion nimmt dieselben Filter entgegen und trifft damit genau die Menge, die hier steht - wer die Liste gefiltert hat, hat die Vorschau schon gesehen.

─── Warum die Filter stufe_* heissen und nicht level_* ─────────────

Weil sie in der Oberflaeche "Stufe von / bis" heissen und der Reiter sie genau so schickt. Ein Parameter, den niemand so nennt, wie er ausgeschrieben wird, ist ein Parameter, der stillschweigend ignoriert wird - FastAPI verwirft unbekannte Abfrageteile ohne Fehler, und die Liste stand dann ungefiltert da, obwohl der Filter gesetzt war.

Dasselbe gilt fuer die Sortierung. Die vier Werte sind die vier Auswahleintraege der Oberflaeche (xp, stufe, aktiv, name); die alten Namen (rang, xp_gesamt, aktivitaet) hat nie jemand geschickt, und xp haette als unbekannter Wert einen 422 ergeben - also einen Reiter, der gar nichts zeigt.

─── Warum die Namenssuche ueber Discord und nicht ueber die Datenbank ──

users.username ist der GLOBALE Discord-Name und veraltet: er wird nur beim ersten Kontakt geschrieben. Der Servername (Nickname) steht dort gar nicht. Eine Suche darueber faende genau die Leute nicht, die sich umbenannt haben.

Deshalb: die Mitgliederliste des Servers kommt aus guild_live (Discord, mit Cache), und die Suche laeuft darauf. Ist sie nicht verfuegbar, faellt die Suche auf die Discord-ID zurueck - das ist wenig, aber es ist richtig, und der Aufrufer erfaehrt es (namen_verfuegbar).

get/api/v1/servers/{server_id}/level/mitglieder

Request

  • Base URL: https://api.notoq.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.notoq.xyz/api/v1/servers/{server_id}/level/mitglieder
  • Auth: HTTP bearer

Path parameters

server_idstring required

Discord Server ID

Query parameters

suchestring nullable

Discord-ID oder Namensteil

stufe_voninteger nullable
stufe_bisinteger nullable
inaktiv_tageinteger nullable
nur_eingefrorenboolean
sortierung'xp' | 'stufe' | 'aktiv' | 'name'
seiteinteger
pro_seiteinteger

Response

Successful Response

successboolean required
dataobject required
messagestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.