LeagueOfDataBase API'si

Kimlik doğrulama

Her /v1 isteği anahtarını taşır — biçim: lodb_ ve ardından 40 onaltılık karakter — iki başlıktan birinde. Sunucuda yalnızca SHA-256 parmak izi saklanır: kaybolan anahtar yeniden oluşturulur, asla geri getirilmez.

Authorization: Bearer lodb_…
X-Api-Key: lodb_…

Temel URL: https://api.league-of-data-base.com

Uç noktalar

• GET/healthz

  Servis durumu — kimlik doğrulaması gerektirmeyen tek rota.

• GET/v1/profiles/{username}

  Bir üyenin herkese açık profili: favoriler ve herkese açık build sayısı (profil gizliyse 404).

• GET/v1/champions/{championId}/builds

  Bir şampiyonun herkese açık buildleri (Data Dragon id'si), en yeniden eskiye — page ve per_page ile sayfalanır (en çok 50).

• GET/v1/trends/{type}

  Sitede en çok görüntülenen varlıklar: şampiyonlar, eşyalar, rünler veya sihirdar büyüleri — range=7d (varsayılan) veya 30d, ilk 25.

• GET/v1/usage

  Çağıran anahtarın canlı tüketimi — kimlik doğrulamalı ve hız limitli, ama asla kotadan düşülmez.

curl -H "Authorization: Bearer lodb_votrecle…" \
  "https://api.league-of-data-base.com/v1/trends/champions?range=30d"

curl -H "X-Api-Key: lodb_votrecle…" \
  "https://api.league-of-data-base.com/v1/usage"

{
  "plan": "free",
  "monthly_quota": 500,
  "used_this_month": 137,
  "remaining_this_month": 363,
  "credits_balance": 0,
  "rate_limit_per_min": 10
}

Kotalar ve hız limiti

Her istek önce planının aylık kotasına, sonra ön ödemeli kredilere yazılır; ikisi de tükenince API 429 quota_exceeded döner.

Anahtar başına token bucket: her /v1 yanıtı X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset taşır; limitin üzerinde 429 rate_limited.

Kotalar takvim ayıyla sıfırlanır. Yıllık planlar hacimlerini aylık kota olarak taşır (ayda 20 000 veya 60 000 istek).

Hatalar

Tüm hatalarda tek tip zarf. Kodlar: unauthorized (401), forbidden (403, iptal edilmiş anahtar), not_found (404), rate_limited ve quota_exceeded (429), invalid_request (400), internal (500/503).

{ "error": { "code": "rate_limited", "message": "rate limit exceeded, retry after X-RateLimit-Reset" } }

Fiyatlar

Kredi paketleri: 1 000 istek başına 1 €, etkin planın aylık kotasından sonra harcanır, 12 ay geçerli. Yıllık planlar hacimlerini aylık kota olarak taşır, yıllık faturalanır.

Faturalama ve anahtar yönetimi

Anahtarlar profilinden oluşturulur ve yönetilir; paketler ve abonelikler Stripe Checkout ile ödenir — API'nin kendisi asla ödeme verilerine dokunmaz.