Öffentliche API-Referenz
Mit der Xponent REST API können Sie Bestenlisten- und Mitgliedsdaten für Ihren Server aus jeder externen Anwendung lesen.
Basis-URL
https://xponentbot.xyz/api/v1
Authentifizierung
Übergeben Sie Ihren Server-API-Schlüssel im x-api-key-Header. Schlüssel aus Dashboard → API-Schlüssel generieren.
x-api-key: YOUR_API_KEY
GET
/servers/{guild_id}/leaderboard
Gibt die obersten Mitglieder absteigend nach XP sortiert zurück.
Abfrageparameter
- Limit (Standard 10, max 100)
- Seite (Standard 1)
Beispielantwort
{"data":[{"rank":1,"user_id":123456",username":Alice",level":42,"xp":176400}],"total":1240,"page":1}
GET
/servers/{guild_id}/members/{user_id}
Gibt XP, Level, Rang, Streak und zurück last_daily_claim für ein bestimmtes Mitglied.
Beispielantwort
{"user_id":"123456","username":"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
GET
/servers/{guild_id}/stats
Gibt aggregierte Serverstatistiken zurück: Gesamtzahl der Mitglieder mit XP, insgesamt verdiente XP, durchschnittliches Level und Kurvenkonfiguration.
Beispielantwort
{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard","xp_multiplier":1.0
Ratenbegrenzungen
100 req/hr
Kostenloser Plan
1.000 erforderlich/Std.
Starterplan
10.000 req/hr
Pro-Plan