İçeriğe geç
HepOyuncu Forum
HepOyuncu.com | DDoS Korumalı CS 1.6 · CS2 & CS:GO · TeamSpeak 3 Sunucu Kiralama — Aylık 500 TL'den başlayan fiyatlar
HEPOYUNCU.COMSUNUCU KİRALA →HEPOYUNCU TS3TS3 BOTU İNCELE →HEPOYUNCU FORUMARŞİVE GİT →
HEPOYUNCU FORUM
MERHABALAR DEĞERLİ ÜYELERİMİZ FORUM SAYFAMIZA HOŞ GELDINIZ...
CS 1.6 SUNUCU KİRALA
30+2 SLOT · 500 TL / AYDDoS KORUMALI ALTYAPIANINDA KURULUM
CS2 & CS:GO · TEAMSPEAK 3
128 TICK · ANINDA KURULUMTS3 + ÜCRETSİZ BOTTÜRKÇE WEB PANEL

[Rehber] TS3 WebQuery: HTTP üzerinden sunucu yönetimi ve API anahtarı

22-11-2026, 20:48 #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=30

scope 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/clientlist

Adresteki 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.
Bu eklenti HepOyuncu sunucularında hazır!
Eklenti Mağazası'ndan tek tıkla kurun — CS 1.6 sunucu kiralama aylık 500 TL
Sunucu Kirala
Cevap yazmak için giriş yapmalısın.Giriş YapKayıt Ol
Bu konuyu paylaş WhatsApp Telegram X
Bu kategoriden diğer konular
Kimler Çevrimiçi

Toplam 6 kullanıcı çevrimiçi: 0 üye, 6 misafir

En çok 1.725 kişi 19-11-2026, 14:16 tarihinde çevrimiçi oldu.

Forum İstatistikleri

Toplam 688 konu · 699 mesaj · 12 üye

En yeni üyemiz: shark26

Rütbe Renkleri
YÖNETİMMODERATÖREKLENTİ GELİŞTİRİCİSİEKİP ÖLÜMSÜZEFSANE ÜYEUSTA ÜYEUZMAN ÜYEAKTİF ÜYEÜYEYENİ ÜYE
Rütbe sistemi nasıl işler? →
TeamSpeak 3 Sunucu Kirala
Klanınız için TS3 — aylık 150 TL'den başlayan fiyatlar
İncele