パブリック API リファレンス
Xponent REST API を使用すると、任意の外部アプリケーションからサーバーのリーダーボードとメンバー データを読み取ることができます。
ベース URL
https://xponentbot.xyz/api/v1
認証
サーバー API キーを x-api-key ヘッダーに渡します。 「ダッシュボード」→「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、レベル、特定のメンバーのランク、ストリーク、および 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 req/hr
無料プラン
1,000 req/hr
スタータープラン
10,000 req/hr
プロプラン