Genel API Referansı

Xponent REST API şunları sağlar: sunucunuza ilişkin skor tablosu ve üye verilerini herhangi bir harici uygulamadan okursunuz.

Temel URL

https://xponentbot.xyz/api/v1

Kimlik Doğrulama

Sunucu API anahtarınızı x-api-key başlığına iletin. Anahtarları Kontrol Paneli → API Anahtarları'ndan 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, seri 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 talep/saat
Ücretsiz plan
1.000 talep/saat
Başlangıç planı
10.000 talep/saat
Pro plan