Zum Inhalt

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.

GET /api/terminal/v1/ping HTTP/1.1
Host: 192.168.50.10:7990
Authorization: Bearer nltm_…

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 v1 im 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.