API
Sunucunun verisi,kendi araçlarında.
Premium sunucular için salt okunur bir API: kimler oyunda, maç, oyuncular, kill'ler ve geçmiş. Anahtarlar WARPANEL → Ayarlar → API bölümünde oluşturulur.
Endpoint'ler · warpanel.gg/api/v1Salt okunur
GET/v1/serversSunucuların şu anda (sunucu tarayıcısı)
GET/v1/serverSunucu şu anda
GET/v1/playersOyuncular ve istatistikleri (sıralamalar)
GET/v1/players/{steamId}Tek bir oyuncu
GET/v1/matchesSon maçlar
GET/v1/eventsOlay akışı (kill'ler ve maç sonuçları)
GET/v1/weaponsSilahlar
GET/v1/mapsHaritalar
GET/v1/totalsToplamlar (bugün, sezon, tüm zamanlar)
GET/v1/historyGeçmiş ve en yoğun saatler
~❯curl -H "Authorization: Bearer $WARPANEL_API_KEY" https://warpanel.gg/api/v1/server
{
"server": {
"id": "x7k2p9",
"name": "[DOGS] Dog House EU | KOTK",
"joinCode": "ABCD1234",
"region": "eu-central",
"source": "rcon"
},
"online": true,
"players": {
"current": 58,
"max": 100
},
"match": {
"map": "Bakurani",
"lighting": "Day",
~❯
Nasıl çalışır
- 01HTTPS üzerinden salt okunur JSON. Temel URL: https://warpanel.gg/api/v1
- 02Kimlik doğrulama: anahtarı
Authorization: Bearer wpk_…(ya daX-API-Key: wpk_…) olarak gönder. Anahtarları sunucunun sahibi WARPANEL → Ayarlar → API bölümünde oluşturur. Sunucu anahtarı tek bir sunucuyu okur; ağ anahtarı (yalnızca sahip) sahibin WARPANEL'deki tüm sunucularını okur. - 03Ağ anahtarları sunucuyu ?server=<id> ile seçer (id'ler GET /servers'tan gelir; slug ya da katılma kodu da çalışır) ya da sunucuları birleştirmek için ?server=all kullanır (oyuncular Steam ID'ye göre birleştirilir). ?server olmadan, birleştirebilen endpoint'ler birleştirir (all), /server ise bir sunucu ister. Sunucu anahtarı ?server'ı atlayabilir.
- 04Yalnızca Premium sunucular. Oluşturulduğu sunucu Free plandayken anahtar yanıt vermez (403 premium_required).
- 05Anahtar başına dakikada 60 istek. Header'lar: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (saniye). Sınır aşılırsa: Retry-After ile 429.
- 06Bizim tarafta canlı veri 10 saniye, olay akışı 5 saniye, istatistikler 1–2 dakika ve geçmiş 10 dakika önbelleğe alınır, yani daha sık sorgulamak bir şey kazandırmaz. Kendi tarafında da önbelleğe al (bir web sitesi için 30–60 sn fazlasıyla yeterli).
- 07Zamanlar UTC'de ISO 8601 biçimindedir. /totals ve /history, "bugün" ve en yoğun saatler için ?tz= (Europe/Berlin gibi bir IANA bölgesi) alır. Steam ID'ler 17 haneli SteamID64 dizeleridir. Takımlar Valkyra (kırmızı), Lonestar (mavi) ve Manticore (yeşil); bir sunucu en fazla 100 oyuncu alır.
- 08Kendini sıralamalardan gizleyen oyuncular oyuncu listelerine dahil edilmez; diğer yerlerde (canlı liste, maçlar, olaylar) steamId null olarak "Gizli oyuncu" şeklinde görünürler.
- 09CORS, GET için açıktır, ama anahtarı bir sunucuda tut (backend route, serverless fonksiyon ya da Cloudflare Worker) — tarayıcı JavaScript'indeki her şeyi her ziyaretçi okuyabilir.