Openbare API-referentie

Met de Xponent REST API kunt u leaderboard- en ledengegevens voor uw server lezen vanuit elke externe applicatie.

Basis-URL

https://xponentbot.xyz/api/v1

Authenticatie

Geef de API-sleutel van uw server door in de x-api-key header. Genereer sleutels via Dashboard → API-sleutels.

x-api-key: YOUR_API_KEY
GET /servers/{guild_id}/leaderboard

Retourneert de topleden gesorteerd op aflopende XP.

Queryparameters

  • limiet (standaard 10, max. 100)
  • pagina (standaard 1)

Voorbeeldantwoord

{"data":[{"rank":1,"user_id":123456",username"Alice","level":42,"xp":176400}],"total":1240,"page":1}
GET /servers/{guild_id}/members/{user_id}

Retourneert XP, level, rang, streak en last_daily_claim voor een specifiek lid.

Voorbeeldreactie

{"user_id"123456","username"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
GET /servers/{guild_id}/stats

Retourneert de verzamelde server statistieken: totaal aantal leden met XP, totaal verdiende XP, gemiddeld niveau en curve-configuratie.

Voorbeeldreactie

{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve" "standaard", xp_multiplier":1.0}

Tarieflimieten

100 vereist/uur
Gratis abonnement
1.000 vereist/uur
Startersabonnement
10.000 vereisten/uur
Pro-abonnement