Referencia de API pública
La API REST de Xponent le permite leer la tabla de clasificación y los datos de miembros de su servidor desde cualquier aplicación externa.
URL base
https://xponentbot.xyz/api/v1
Autenticación
Pase la clave API de su servidor en x-api-key encabezado. Genere claves desde Panel → Claves API.
x-api-key: YOUR_API_KEY
GET
/servers/{guild_id}/leaderboard
Devuelve los miembros principales ordenados por XP descendente.
Parámetros de consulta
- límite (predeterminado 10, máximo 100)
- página (predeterminada 1)
Respuesta de ejemplo
{"data":[{"rank":1,"user_id":"123456","username":"Alice","level":42,"xp":176400}],"total":1240,"page":1}
GET
/servers/{guild_id}/members/{user_id}
Devuelve XP, nivel, rango, racha y last_daily_claim para un miembro específico.
Respuesta de ejemplo
{"user_id":"123456","username":"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
GET
/servers/{guild_id}/stats
Devuelve un servidor agregado estadísticas: total de miembros con XP, total de XP obtenidos, nivel promedio y configuración de curva.
Respuesta de ejemplo
{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard","xp_multiplier":1.0}
Límites de tarifas
100 solicitudes/hora
Plan gratuito
1000 solicitudes/hora
Plan inicial
10,000 req/hr
Plan Pro