Fiyat API

Knight Online ve Rise Online GB fiyatlarını JSON olarak kendi sitenize / botunuza çekin.

Erişim

API bir token ile çalışır. Token almak için bize ulaşın (iletişim). Token'ı üç yoldan biriyle gönderebilirsiniz:

Authorization: Bearer kgb_xxxxxxxx        (önerilen)
X-API-Key: kgb_xxxxxxxx
https://kogbtakip.com/api/v1/prices?token=kgb_xxxxxxxx   (hızlı test için)

Birim: tüm fiyatlar TL / 1 GB (100M) cinsindendir (Rise Online dahil).
alis = sitenin alış fiyatı (site sizden GB alır → siz satarsınız). satis = sitenin satış fiyatı (site size GB satar → siz alırsınız).
Veriler siteler tarafından yaklaşık 5 dakikada bir yenilenir; updated_at / age_sec alanına bakın. Ardışık isteklerde 30 sn önbellek vardır, daha sık sorgulamanın anlamı yoktur.

Endpoint'ler

GEThttps://kogbtakip.com/api/v1/prices

Seçilen oyunun tüm siteler × sunucular fiyat tablosu + her sunucu için en iyi alış/satış.

Parametre	Açıklama
`game`	`ko` (varsayılan), `riseonline`, `risemobile`
`server`	İsteğe bağlı filtre, virgülle çoklu: `zero,felis`
`site`	İsteğe bağlı filtre, virgülle çoklu: `kopazar,bynogame`

{
  "ok": true,
  "game": "ko", "game_name": "Knight Online",
  "unit": "TL / 1 GB (100M)",
  "updated_at": "2026-08-30T15:11:50+03:00", "age_sec": 103, "stale": false,
  "servers": ["zero","felis","pandora","agartha","dryads","destan","minark","oreads"],
  "best": {
    "zero": { "alis": 417.0, "alis_site": "kopazar", "satis": 435.0, "satis_site": "sonteklif" },
    ...
  },
  "sites": {
    "kopazar": {
      "name": "KoPazar", "url": "https://www.kopazar.com/knight-online-gold-bar",
      "status": "ok", "last_update": "15:11:29", "stale_min": 0,
      "prices": { "zero": { "alis": 417.0, "satis": 438.0 }, "felis": { ... } }
    },
    ...
  },
  "kc400_tl": 222.5
}

GEThttps://kogbtakip.com/api/v1/best

prices ile aynı, sadece sites bloğu yoktur (küçük cevap; yalnızca en iyi fiyatlar). Aynı parametreler.

GEThttps://kogbtakip.com/api/v1/games

Desteklenen oyunlar, sunucu ve site listeleri.

{ "ok": true, "unit": "TL / 1 GB (100M)",
  "games": [ { "key": "ko", "name": "Knight Online", "servers": [...], "sites": [...] }, ... ] }

GEThttps://kogbtakip.com/api/v1/history

Bir sunucunun en iyi alış/satış fiyat geçmişi.

Parametre	Açıklama
`game`	Oyun (varsayılan `ko`)
`server`	Zorunlu. Örn. `zero`
`days`	1–30 (varsayılan 7). 2 günden uzun aralıklarda saatlik ortalama döner.

{ "ok": true, "game": "ko", "server": "zero", "days": 7, "count": 168,
  "points": [ { "t": "2026-08-23T15:00:00+03:00", "alis": 405.0, "satis": 430.0 }, ... ] }

GEThttps://kogbtakip.com/api/v1/me

Token bilgisi ve kullanım sayaçları (günlük/toplam istek, limitler).

Limitler ve hatalar

Her token'ın dakikalık ve günlük istek limiti vardır; kalan hak X-RateLimit-* başlıklarında döner. Hata cevapları her zaman {"ok": false, "error": "..."} biçimindedir.

Kod	Anlamı
401	Token yok / geçersiz
403	Token pasif veya süresi dolmuş
429	Limit doldu (`Retry-After` başlığına bakın)
503	Fiyat kaynağı geçici olarak ulaşılamaz

Örnekler

curl -H "Authorization: Bearer kgb_xxxxxxxx" "https://kogbtakip.com/api/v1/best?game=ko"

import requests
r = requests.get("https://kogbtakip.com/api/v1/prices", params={"game": "ko", "server": "zero"},
                 headers={"Authorization": "Bearer kgb_xxxxxxxx"}, timeout=15)
data = r.json()
print(data["best"]["zero"])          # {'alis': 417.0, 'alis_site': 'kopazar', 'satis': 435.0, ...}
for site, s in data["sites"].items():
    print(site, s["prices"].get("zero"))

$ch = curl_init("https://kogbtakip.com/api/v1/best?game=ko");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer kgb_xxxxxxxx"]]);
$data = json_decode(curl_exec($ch), true);
echo $data["best"]["zero"]["alis"];   // 417

const r = await fetch("https://kogbtakip.com/api/v1/best?game=ko", {
  headers: { "Authorization": "Bearer kgb_xxxxxxxx" }
});
const data = await r.json();
console.log(data.best.zero);   // CORS açık: tarayıcıdan da çağrılabilir