公共 API 参考
Xponent REST API 允许您从任何外部应用程序读取服务器的排行榜和成员数据。
基本 URL
https://xponentbot.xyz/api/v1
身份验证
在 x-api-key 标头中传递您的服务器 API 密钥。从仪表板 → API 密钥生成密钥。
x-api-key: YOUR_API_KEY
GET
/servers/{guild_id}/leaderboard
返回按 XP 降序排序的顶级成员。
查询参数
- 限制（默认 10，最大） 100)
- 页面（默认 1）
响应示例
{"data":[{"rank":1,"user_id":"123456","username":"Alice","level":42,"xp":176400}],"total":1240,"page":1}
GET
/servers/{guild_id}/members/{user_id}
返回 XP、等级，特定会员的排名、streak 和 last_daily_claim。
响应示例
{"user_id":"123456","username":"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
GET
/servers/{guild_id}/stats
返回聚合服务器统计信息：拥有 XP 的会员总数、获得的 XP 总数、平均等级和曲线配置。
响应示例
{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard","xp_multiplier":1.0}
速率限制
100 请求/小时
免费计划
1,000 个请求/小时
入门计划
10,000 请求/小时
专业计划