Genel API Referans
Xponent REST API, herhangi bir harici uygulamadan sunucunuz için sıralama tablosu ve üye verilerini okumanıza olanak tanır.
Temel URL
https://xponentbot.xyz/api/v1
Kimlik Doğrulama
Sunucu API anahtarınızı x-api-key başlığına iletin. Kontrol Paneli → API Anahtarları'ndan anahtar oluşturun.
x-api-key: YOUR_API_KEY
GET
/servers/{guild_id}/leaderboard
En üstteki üyeleri XP'den azalan şekilde sıralayarak döndürür.
Sorgu parametreleri
- sınır (varsayılan 10, maksimum 100)
- sayfa (varsayılan 1)
Örnek yanıt
{"data":[{"rank":1,"user_id":"123456","username":"Alice","level":42,"xp":176400}],"total":1240,"page":1}
GET
/servers/{guild_id}/members/{user_id}
XP'yi, seviyeyi döndürür, Belirli bir üye için sıralama, galibiyet serisi ve last_daily_claim.
Örnek yanıt
{"user_id":"123456","username":"Alice","level":42,"xp":176400,"rank":1,"daily_streak":7}
GET
/servers/{guild_id}/stats
Toplu sunucu istatistiklerini döndürür: XP'li toplam üye sayısı, kazanılan toplam XP, ortalama seviye ve eğri yapılandırması.
Örnek yanıt
{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard","xp_multiplier":1.0}
Hız Sınırları
100 req/hr
Ücretsiz plan
1.000 talep/saat
Başlangıç planı
10.000 talep/saat
Profesyonel plan