공개 API 참조
XComponent 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, 레벨, 순위, 연속 및 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회 요청
프로 플랜