API-Dokumentation

NOOB-TOWN stellt eine kleine oeffentliche Topscore-API fuer Browsergames bereit. Die API ist nicht fuer Suchmaschinenindexierung gedacht und bleibt in robots.txt fuer Crawler gesperrt.

Discovery

• API Catalog im Format application/linkset+json
• OpenAPI-Beschreibung im JSON-Format
• Spielkatalog fuer Agenten und Crawler

Endpoints

GET /api/topscores

Liefert die aktuellen Weltrekorde als JSON-Objekt, geordnet nach stabiler Spiel-ID.

GET /api/topscore?game=<id>

Liefert den aktuellen Weltrekord fuer ein einzelnes Spiel.

POST /api/topscore

Nimmt JSON mit game und score entgegen. Submits sind validiert, pro Spiel begrenzt und per taeglichem IP-Hash rate-limitiert.

Authentifizierung

Die aktuelle API nutzt keine OAuth- oder OIDC-Authentifizierung. Deshalb veroeffentlicht NOOB-TOWN keine OAuth-Discovery- oder Protected-Resource-Metadaten.