Terminal-API¶
Das Spieler-Terminal spricht mit NestrisLTM ausschließlich über diese REST-API. Der Basispfad ist /api/terminal/v1. Jede Anfrage trägt ein Bearer-Token mit Scope terminal. Das Token liegt in der lokalen Bridge des Terminals und erreicht nie die Browser-Oberfläche.
Endpunkte¶
| Methode | Pfad | Zweck |
|---|---|---|
GET |
/ping |
Erreichbarkeit und Server-Version |
GET |
/card/{uid}?name= |
Wem gehört die Karte? Antwort known, name_match oder unknown |
POST |
/card/{uid}/link |
Karten-UID einem bestehenden Spieler zuordnen |
GET |
/nickname?value= |
Ist der Nickname noch frei? |
POST |
/players |
Neuen Spieler anmelden (mit E-Mail-Einwilligung) |
GET |
/players/{id} |
Spielerprofil: Statistik, Events, Spiele |
POST |
/players/{id}/games |
Selbst eingetragener Score (markiert als self_reported) |
GET |
/highscore |
Rangliste des aktiven Events |
GET |
/games/{id}/recording |
NGF-Aufzeichnung für den Replay-Viewer |
Logik der Kartenabfrage¶
flowchart TD
A["<span style='color:#111111'>Karte aufgelegt<br/>UID + Name vom Leser</span>"]:::rfid --> B{"<span style='color:#111111'>GET /card/{uid}</span>"}:::ltm
B -- known --> P["<span style='color:#111111'>Spielerseite öffnen</span>"]:::term
B -- name_match --> L["<span style='color:#111111'>POST /card/{uid}/link<br/>(ältere Karte, Name bekannt)</span>"]:::ltm --> P
B -- unknown --> R["<span style='color:#111111'>Anmeldung mit<br/>dieser Karte</span>"]:::term
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
classDef rfid fill:#f472b6,stroke:#be185d,color:#111,stroke-width:2px
Designhinweise¶
- Kein direkter Datenbankzugriff. Das Terminal lässt sich austauschen, neu starten oder auf jedem PC im LAN betreiben, ohne die Datenbank anzufassen.
- Versionierter Pfad. Das
v1im Pfad erlaubt es, die Schnittstelle weiterzuentwickeln, ohne bereits aufgestellte Terminals zu stören. - Geringste Rechte. Ein
terminal-Token kann Spieler anmelden, Karten zuordnen, selbst eingetragene Scores anlegen und öffentliche Daten lesen. Es kann keine bestehenden Spiele und keine Einstellungen ändern. - Datenschutz. Öffentliche Listen enthalten nur Nicknames. Eine E-Mail-Adresse wird nur mit Einwilligung des Spielers gespeichert.