API-Endpoints

Basis-URL: https://rentanarcade.quiztreff.de/rentanarcade/api/v1/

GET /scores

Highscores abrufen. Filterbar nach Automat und Spieler.

Parameter	Typ	Pflicht	Beschreibung
`arcade_id`	String	Nein	Nur Scores eines bestimmten Automaten
`player_id`	String	Nein	Nur Scores eines bestimmten Spielers
`limit`	Int	Nein	Max. Ergebnisse (1-100, Standard: 25)
`offset`	Int	Nein	Pagination-Offset

Response:

{
  "ok": true,
  "data": [
    {
      "id": 42,
      "arcade_id": "arc_abc123",
      "game_key": "dishtennis",
      "player_id": "user-42",
      "player_name": "Max",
      "score": 4200,
      "custom_values": ["kampagne-1", "newsletter"],
      "origin_domain": "meinshop.de",
      "created_at": "2026-03-28 18:30:00"
    }
  ],
  "pagination": { "total": 156, "limit": 25, "offset": 0 }
}

GET /arcades

Alle deine Arcade-Automaten auflisten.

GET /arcades/{arcade_id}

Details eines Automaten inkl. Top-10 Highscores und Gesamtstatistiken.

{
  "ok": true,
  "data": {
    "arcade_id": "arc_abc123",
    "game_key": "dishtennis",
    "display_name": "Oster-Gewinnspiel",
    "status": "active",
    "webhook_url": "https://meinshop.de/api/arcade-hook",
    "custom_fields": ["Kampagne", "Kanal"]
  },
  "top_scores": [...],
  "total_plays": 1523
}

POST /arcades/{arcade_id}/webhook

Webhook-URL setzen oder ändern. Bei jedem Spielende wird ein POST an diese URL gesendet.

Body	Typ	Pflicht	Beschreibung
`url`	String	Ja	HTTPS-URL (leer = deaktivieren)

POST /arcades/{arcade_id}/fields

Labels für die 4 Custom-Felder setzen (für deine Dokumentation im Dashboard).

{ "field_1": "Kampagne", "field_2": "Kanal", "field_3": "Usertyp", "field_4": "Region" }

POST /webhook/test

Test-Webhook an die konfigurierte URL senden. Sendet einen Dummy-Score mit "test": true.

{ "arcade_id": "arc_abc123" }