A LeagueOfDataBase API

Hitelesítés

Minden /v1 kérés a kulcsodat viszi — formátum: lodb_ és 40 hexadecimális karakter — a két fejléc egyikében. A szerveren csak az SHA-256 ujjlenyomat tárolódik: az elveszett kulcsot újrageneráljuk, sosem állítjuk vissza.

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

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

Végpontok

• GET/healthz

  Szolgáltatás állapota — az egyetlen hitelesítés nélküli útvonal.

• GET/v1/profiles/{username}

  Egy tag nyilvános profilja: kedvencek és nyilvános buildek száma (privát profilnál 404).

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

  Egy hős (Data Dragon id) nyilvános buildjei, a legújabbtól — lapozás page és per_page paraméterrel (max. 50).

• GET/v1/trends/{type}

  Az oldal legnézettebb entitásai: hősök, tárgyak, rúnák vagy idézőikonok varázslatai — range=7d (alapértelmezett) vagy 30d, top 25.

• GET/v1/usage

  A hívó kulcs élő fogyasztása — hitelesített és sebességkorlátos, de sosem számít bele a keretbe.

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
}

Keretek és sebességkorlát

Minden kérés először a csomag havi keretét, majd az előre fizetett krediteket terheli; ha mindkettő elfogyott, az API 429 quota_exceeded választ ad.

Kulcsonkénti token bucket: minden /v1 válasz tartalmazza az X-RateLimit-Limit, X-RateLimit-Remaining és X-RateLimit-Reset fejléceket; a korlát felett 429 rate_limited.

A keretek a naptári hónappal nullázódnak. Az éves csomagok a mennyiséget havi keretként hordozzák (havi 20 000 vagy 60 000 kérés).

Hibák

Egységes boríték minden hibán. Kódok: unauthorized (401), forbidden (403, visszavont kulcs), not_found (404), rate_limited és quota_exceeded (429), invalid_request (400), internal (500/503).

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

Árak

Kreditcsomagok: 1 000 kérésenként 1 €, az aktív csomag havi kerete után fogynak, 12 hónapig érvényesek. Az éves csomagok a mennyiséget havi keretként hordozzák, évente számlázva.

Számlázás és kulcskezelés

A kulcsokat a profilodból hozod létre és kezeled; a csomagokat és előfizetéseket a Stripe Checkout kezeli — maga az API sosem ér fizetési adatokhoz.