Справочник по общедоступному API

XComponent 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 запросов/час
Бесплатный план
1000 запросов/час
Стартовый план
10 000 запросов в час
Про-план