Referência de API pública
A API REST Xponent permite que você leia a tabela de classificação e os dados dos membros do seu servidor a partir de qualquer aplicativo externo.
URL base
https://xponentbot.xyz/api/v1
Autenticação
Passe a chave de API do servidor no cabeçalho x-api-key. Gere chaves do Painel → Chaves de API.
x-api-key: YOUR_API_KEY
GET
/servers/{guild_id}/leaderboard
Retorna os principais membros classificados por XP decrescente.
Parâmetros de consulta
- limit (padrão 10, máx. 100)
- página (padrão 1)
Exemplo de resposta
{"data":[{"rank":1,"user_id":"123456","username":"Alice","level":42,"xp":176400}],"total":1240,"page":1}
GET
/servers/{guild_id}/members/{user_id}
Retorna XP, nível, classificação, sequência e last_daily_claim para um membro específico.
Exemplo de resposta
{"user_id":"123456","username":"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
GET
/servers/{guild_id}/stats
Retorna estatísticas agregadas do servidor: total de membros com XP, total de XP ganho, nível médio e configuração de curva.
Exemplo de resposta
{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard","xp_multiplier":1.0}
Limites de taxa
100 req/hora
Grátis planejar
1.000 solicitações/hora
Plano inicial
10.000 solicitações/hora
Plano Pro