Beheer

Deze routes staan onder /api/v1/admin en zijn alleen voor de eigenaar van de server. Ze staan aan als de engine draait met MINI_ENGINE_ADMIN_TOKEN (minstens 32 tekens); anders geeft elke route 404 admin_disabled. Stuur het token mee als Authorization: Bearer <admintoken>. Een verkeerd token geeft 401. Zie ook beheer voor de eigenaar.

Dev-keys #

POST /api/v1/admin/dev-tokens #

JSON

{ "username": "sander", "label": "laptop", "expires_in_days": 365 }

label (1–80 tekens, standaard cli) en expires_in_days (1–3650, of weglaten voor geen verloopdatum) zijn optioneel. Antwoord 201:

JSON

{
  "id": "uuid",
  "token": "med_3f9a…",
  "username": "sander",
  "display_name": "Sander",
  "label": "laptop",
  "created_at": 1792660000,
  "expires_at": 1824196000
}

Het token staat alleen in dit antwoord; de server bewaart een SHA-256-hash.

Fout	Wanneer
404 `account_not_found`	Onbekende gebruikersnaam
409 `email_not_verified`	Het account heeft nog geen bevestigd e-mailadres (vanaf 0.4)

GET /api/v1/admin/dev-tokens #

JSON

{
  "tokens": [
    {
      "id": "uuid", "username": "sander", "display_name": "Sander", "label": "laptop",
      "created_at": 1792660000, "expires_at": null, "last_used_at": 1792661234, "revoked_at": null
    }
  ]
}

Nieuwste eerst, zonder geheimen.

DELETE /api/v1/admin/dev-tokens/{id} #

Trekt de key in: 204. Hij werkt meteen niet meer. Al ingetrokken of onbekend: 404 token_not_found.

Accounts #

POST /api/v1/admin/accounts/{username}/verify-email #

Bevestigt het e-mailadres van een account met de hand, voor wie de bevestigingsmail niet krijgt. Geen body. Antwoord 200:

JSON

{ "username": "sander", "email": "sander@example.com", "email_verified": true }

Was het adres al bevestigd, dan blijft dat zo en volgt hetzelfde antwoord. De actie komt in audit_log.

Fout	Wanneer
404 `account_not_found`	Onbekende gebruikersnaam
409 `email_missing`	Het account heeft geen e-mailadres

Games #

GET /api/v1/admin/games #

{ "games": [DevGame + owner, …] }: alle geüploade games, met owner: { id, username, display_name }. Zie ontwikkelaars voor DevGame.

PUT /api/v1/admin/games/{id} #

JSON

{ "enabled": false }

false blokkeert de game (blocked: true): de engine serveert er niets meer van, ook niet aan lopende kamers, en de ontwikkelaar kan hem niet zelf weer aanzetten. true heft de blokkade op en zet de game aan. Geeft de DevGame met owner terug.