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).
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
Discord Server ID
Query parameters
Discord-ID oder Namensteil
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.