Topluluk

Geliştirici API'si

Discord botları, lonca siteleri ve topluluk araçları için salt okunur JSON uçları. Ücretsiz; bir anahtar alman yeterli.

Başlarken

Giriş yap ve bu sayfadan bir anahtar oluştur (hesap başına en çok 3).
Her isteğe Authorization: Bearer ko_… başlığını ekle. Tarayıcıdan denemek için ?anahtar=ko_… da olur (anahtarını herkese açık sayfalara gömme).
Yanıtlar her zaman JSON: başarıda { "ok": true, "veri": … }, hatada { "ok": false, "hata": { "kod", "mesaj" } }.

curl -H "Authorization: Bearer ko_ANAHTARIN" \
  https://tgwar.online/api/v1/karakter/Korkut

{
  "ok": true,
  "veri": {
    "ad": "Korkut",
    "seviye": 87,
    "sinif": "Savaşçı",
    "harita": "Eminönü",
    "lonca": "Demir Yumruk",
    "taraf": "arz",
    "pvp": { "galibiyet": 120, "maglubiyet": 31, "oldurme": 402 },
    "kusanim": [ { "yuva": "silah", "esyaId": 4300, "ad": "Yatağan", "arti": 7 } ],
    "basarimlar": [ … ],
    "cevrimici": true,
    "sayfa": "https://tgwar.online/karakter/Korkut"
  }
}

Uçlar

Uç (GET)	Açıklama	Parametreler
/api/v1/durum	Sunucu durumu, çevrimiçi oyuncu, sürüm, bakım.	—
/api/v1/siralama	Seviye, klan ya da lonca sıralaması.	tur=seviye\|klan\|lonca, sinir=1–100
/api/v1/karakter/{ad}	Karakter özeti: seviye, sınıf, taraf, lonca, kuşanım, başarımlar.	—
/api/v1/lonca/{ad}	Lonca: seviye, puan, taraf, lider, üyeler.	—
/api/v1/etkinlikler	Yaklaşan etkinlikler (tekrarlar açılmış).	gun=1–60 (varsayılan 14)
/api/v1/haberler	Yayındaki haberler.	dil=tr\|en\|…, kategori, sinir=1–50
/api/v1/esya/{id}	Ansiklopedi: eşya özellikleri.	—
/api/v1/yama-notlari	Son yama notları ve denge değişiklikleri.	sinir=1–30

Taraf değerleri: tarafsiz, arz, lodos. Tarihler ISO 8601 (UTC). Oyun hesap adları (giriş adları) hiçbir uçta dönmez.

Sınırlar

Anahtar başına dakikada 60 istek (X-RateLimit-Limit başlığı). Aşılırsa 429 ve Retry-After.
Yanıtlar 30 sn – 1 saat önbelleklenebilir (Cache-Control). Sıralama 5 dakikada bir yenilenir; daha sık sorma.
CORS açık: tarayıcıdan da çağrılabilir, ama anahtarını istemci koduna gömme; kendi sunucundan çağır.

Hata kodları

400	gecersiz_parametre	Parametre hatalı.
401	anahtar_gerekli / anahtar_gecersiz	Anahtar yok, yanlış ya da iptal edilmiş.
404	bulunamadi	Kayıt yok.
429	istek_siniri	Dakikalık sınır aşıldı; Retry-After başlığına bak.
503	oyun_baglantisi_yok	Oyun sunucusundan veri alınamadı; sonra tekrar dene.

Kullanım şartları

API yalnızca okuma içindir; oyunu otomatikleştiren, hile ya da bot amaçlı araçlarda kullanılamaz.
Veriyi "Korkut Online" kaynağını belirterek göster; resmî uygulama izlenimi verme, logoyu değiştirerek kullanma.
Oyuncuları izlemek, taciz etmek ya da kişisel veri derlemek için kullanılamaz.
Anahtarını paylaşma. Kötüye kullanımda anahtar uyarısız iptal edilir; hesaba yaptırım uygulanabilir.
API ücretsizdir ve "olduğu gibi" sunulur; uçlar önceden duyurularak değişebilir. Sürüm öneki (v1) korunur.

Bir güvenlik açığı bulduysan sorumlu açıklama sayfasından bildir.