22-11-2026, 20:48
TS3 WebQuery: HTTP üzerinden sunucu yönetimi ve API anahtarı#1
Kısa özet: Yeni TS3 sunucu sürümleri klasik ServerQuery'nin yanında HTTP tabanlı WebQuery sunar; web siteleri ve modern botlar için daha kolaydır. API anahtarı ServerQuery'den apikeyadd scope=manage lifetime=30 komutuyla oluşturulur; scope read, write ya da manage olabilir ve yalnızca ihtiyaç duyulan yetki verilmelidir. İstek örneği curl -H "x-api-key: ANAHTAR" http://SUNUCU:10080/1/clientlist biçimindedir ve cevap JSON gelir. Kaçış karakteri sorunu yoktur, kalıcı bağlantı gerekmez. WebQuery portunu herkese açmayın, mümkünse HTTPS kullanın ve anahtarı gizli ayar dosyasında tutun.
TS3 WebQuery: HTTP üzerinden yönetim
WebQuery, ServerQuery'nin HTTP tabanlı alternatifidir ve web siteleriyle entegrasyonu çok kolaylaştırır. Bu konuda anahtar oluşturmayı ve güvenliği anlatıyoruz.
API anahtarı oluşturmak
ServerQuery ile giriş yaptıktan sonra:
KOD
apikeyadd scope=manage lifetime=30scope değeri anahtarın yetkisini belirler (read, write, manage). Sadece ihtiyacınız olan yetkiyi verin.
İstek örneği
KOD
curl -H "x-api-key: ANAHTAR" http://SUNUCU:10080/1/clientlistAdresteki 1 sanal sunucu numarasıdır. Cevap JSON olarak gelir.
Avantajları
- Kaçış karakterleriyle uğraşmazsınız.
- JSON cevap her dilde kolay işlenir.
- Kalıcı bağlantı tutmanız gerekmez.
Güvenlik
- WebQuery portunu herkese açmayın; sadece kendi sunucularınıza izin verin.
- Mümkünse HTTPS üzerinden kullanın.
- API anahtarını kodda değil, gizli bir ayar dosyasında tutun.
Olay dinleme
Olay dinleme (biri girdiğinde haber alma) için klasik ServerQuery bağlantısı hâlâ gereklidir; WebQuery istek-cevap işleri için idealdir.
Sık yapılan hatalar
- Anahtara gereğinden fazla yetki vermek.
- Portu herkese açık bırakmak.
- Anahtarı koda gömmek.
- HTTPS kullanmamak.
- Olay dinleme için de WebQuery beklemek.
Sık sorulan sorular
Anahtar nasıl oluşturulur? ServerQuery ile apikeyadd komutuyla.
Cevap formatı nedir? JSON.
Olayları dinleyebilir miyim? Hayır; bunun için klasik ServerQuery gerekir.
Örnek senaryo
Bir topluluk web sitesinde çevrimiçi kullanıcı listesini göstermek istedi. Yalnızca okuma yetkili bir WebQuery anahtarı oluşturup siteye ekleyince liste canlı güncellendi.
Kontrol listesi
- Anahtar yetkisi sınırlı mı?
- Port korumalı mı?
- HTTPS kullanılıyor mu?
- Anahtar gizli mi?
- Süre doğru ayarlandı mı?
Ek ipucu
Anahtar süresini (lifetime) kısa tutup zaman zaman yenilemek, anahtarın sızması hâlinde riski azaltır; yenileme tarihini bir takvime yazmayı unutmayın. Değişiklikleri önce test ortamında deneyin, çalışan son hâli yedekte tutun ve oyuncu geri bildirimlerini düzenli toplayın; ayarlarınızı gerçek ihtiyaca göre şekillendirmenin en güvenilir yolu budur.
Takıldığınız bir yer olursa bu konunun altına yazın; ekip ve topluluk yardımcı olur.
Ek ipuçları
WebQuery kullanan her uygulama için ayrı bir API anahtarı oluşturun; böylece bir uygulamayı devre dışı bırakmak istediğinizde yalnızca onun anahtarını silersiniz ve diğer uygulamalar etkilenmez. Hangi anahtarın hangi uygulama için olduğunu bir listede tutmak, yönetimi çok kolaylaştırır. Sunucu sürümünüzün WebQuery desteklediğini ve ilgili hizmetin açık olduğunu da önceden kontrol edin.
Ek ipuçları
Test için önce yalnızca okuma yetkili bir anahtarla küçük bir istek deneyin.