Scores API

Manage leaderboards with simple calls. Store raw scores plus metadata like game mode or map to build multiple views.

Fetch scores (basic)

GET /scores?page=1&rows=10

Returns a paged list ordered by score descending by default.

Response (preview)

{
  "page": 1,
  "rows": 10,
  "total": 1234,
  "items": [
    { "player_id": "A1", "score": 5000, "metadata": { "mode": "arcade" } },
    { "player_id": "B2", "score": 4800, "metadata": { "mode": "arcade" } }
  ]
}
    

Submit score (example)

POST /scores
Content-Type: application/json

{
  "player_id": "p_123",
  "score": 4710,
  "metadata": { "mode": "arcade", "map": "intro_forest" }
}
    

Notes

• Ties: equal scores preserve insertion order; advanced tiebreakers available in full docs.
• Filters: by player, time range, or mode (full list gated).
• Anti-cheat: recommended patterns in member docs.