Référence de l'API publique

L'API REST Xponent vous permet de lire le classement et les données des membres de votre serveur à partir de n'importe quelle application externe.

URL de base

https://xponentbot.xyz/api/v1

Authentification

Transmettez la clé API de votre serveur dans la clé x-api en-tête. Générez des clés à partir du tableau de bord → Clés API.

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

Renvoie les principaux membres triés par XP décroissant.

Paramètres de requête

  • limite (10 par défaut, maximum 100)
  • page (par défaut 1)

Exemple de réponse

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

Renvoie l'XP, le niveau, le rang, la séquence et la dernière_réclamation_daily pour un membre spécifique.

Exemple de réponse

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

Renvoie les statistiques globales du serveur : nombre total de membres avec XP, XP total gagné, niveau moyen et configuration de la courbe.

Exemple de réponse

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

Taux Limites

100 req/h
Forfait gratuit
1 000 req/h
Plan de démarrage
10 000 req/h
Plan Pro