Giriş
TrTierlist API'si, platform verilerine erişim sağlayan RESTful bir HTTP API'dir. Bazı endpoint'ler herkese açık, bazıları ise API anahtarı gerektirir.
Base URLhttps://api.trtierlist.com
/api/profile/:name, /api/stats ve /health endpoint'leri herkese açıktır, API anahtarı gerektirmez.
/api/playerlist, /api/leaderboard ve /api2/:kit/:tier endpoint'leri API anahtarı gerektirir. Anahtar almak için API Anahtarı Alma bölümünü okuyun.
API Anahtarı Alma
Korumalı endpoint'lere erişmek için Discord sunucumuz üzerinden bir API anahtarı almanız gerekmektedir.
Discord Bot Komutu: Discord sunucumuzda
/api komutunu kullanarak API anahtarı talebinde bulunabilirsiniz.Adım Adım API Anahtarı Alma
- 1Discord sunucumuza katılın.
- 2Herhangi bir kanalda
/apikomutunu yazın ve gönderin. - 3Açılan modalda proje adınızı ve kullanım amacınızı belirtin.
- 4Formu gönderin, API anahtarınız anında oluşturulur.
- 5Anahtarınızı güvenli bir yerde saklayın.
Önemli: API anahtarınızı kimseyle paylaşmayın.
Kullanım Örneği:
# cURL ile istek curl -H "x-api-key: API_ANAHTARINIZ" https://api.trtierlist.com/api/playerlist
Hata Kodları
200 OK
401 API Key Eksik/Geçersiz
404 Not Found
500 Server Error
Oyuncu Profili & Sıralama
GET/api/profile/:nameOyuncu profili
🌐 Herkese Açık
cURL
curl https://api.trtierlist.com/api/profile/Steve
Sunucu İstatistikleri
GET/api/statsGenel istatistikler
🌐 Herkese Açık
cURL
curl https://api.trtierlist.com/api/stats
Sağlık Kontrolü
GET/healthSunucu durumu
🌐 Herkese Açık
cURL
curl https://api.trtierlist.com/health
Oyuncu Listesi
GET/api/playerlistTüm oyuncular
🔐 API Key Gerekli
cURL
curl -H "x-api-key: API_KEYINIZ" https://api.trtierlist.com/api/playerlist
Liderlik Tablosu
GET/api/leaderboardGlobal sıralama
🔐 API Key Gerekli
cURL
curl -H "x-api-key: API_KEYINIZ" https://api.trtierlist.com/api/leaderboard
Kit Tier Listesi
GET/api2/:kit/:tierKit & Tier filtresi
🔐 API Key Gerekli
cURL
curl -H "x-api-key: API_KEYINIZ" https://api.trtierlist.com/api2/kitht1/HT1