Riferimento API pubblico
L'API REST di Xponent consente leggi la classifica e i dati dei membri per il tuo server da qualsiasi applicazione esterna.
URL di base
https://xponentbot.xyz/api/v1
Autenticazione
Passa la chiave API del tuo server nell'intestazione x-api-key. Genera chiavi da Dashboard → Chiavi API.
x-api-key: YOUR_API_KEY
GET
/servers/{guild_id}/leaderboard
Restituisce i membri principali ordinati per XP discendente.
Parametri query
- limite (predefinito 10, massimo 100)
- pagina (predefinito 1)
Risposta di esempio
{"data":[{"rank":1,"user_id":"123456","username":"Alice","level":42,"xp":176400}],"total":1240,"page":1}
OTTIENI
/servers/{guild_id}/members/{user_id}
Restituisce XP, livello, grado, serie e last_daily_claim per un membro specifico.
Esempio di risposta
{"user_id":"123456","username":"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
OTTIENI
/servers/{guild_id}/stats
Restituisce statistiche aggregate del server: membri totali con XP, XP totali guadagnati, livello medio e configurazione della curva.
Risposta di esempio
{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard","xp_multiplier":1,0}
Limiti di tariffa
100 richieste/ora
Piano gratuito
1.000 richieste/ora
Piano Starter
10.000 richieste/ora
Piano Pro