API LeagueOfDataBase

Autentizace

Každý požadavek /v1 nese váš klíč — formát lodb_ následovaný 40 šestnáctkovými znaky — v jedné ze dvou hlaviček. Na serveru se ukládá jen otisk SHA-256: ztracený klíč se generuje znovu, nikdy neobnovuje.

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

Základní URL: https://api.league-of-data-base.com

Endpointy

• GET/healthz

  Stav služby — jediná trasa bez autentizace.

• GET/v1/profiles/{username}

  Veřejný profil člena: oblíbené a počet veřejných buildů (404 u soukromého profilu).

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

  Veřejné buildy šampiona (id Data Dragon), od nejnovějších — stránkované přes page a per_page (max. 50).

• GET/v1/trends/{type}

  Nejprohlíženější entity webu: šampioni, předměty, runy nebo kouzla vyvolávače — range=7d (výchozí) nebo 30d, top 25.

• GET/v1/usage

  Živá spotřeba volajícího klíče — autentizovaná a limitovaná, ale nikdy se nepočítá do kvóty.

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
}

Kvóty a limit frekvence

Každý požadavek se účtuje nejprve měsíční kvótě plánu, poté předplaceným kreditům; po vyčerpání obojího API odpoví 429 quota_exceeded.

Token bucket na klíč: každá odpověď /v1 nese X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset; nad limit 429 rate_limited.

Kvóty se nulují s kalendářním měsícem. Roční plány nesou objem jako měsíční kvótu (20 000 nebo 60 000 požadavků měsíčně).

Chyby

Jednotná obálka u všech chyb. Kódy: unauthorized (401), forbidden (403, zneplatněný klíč), not_found (404), rate_limited a quota_exceeded (429), invalid_request (400), internal (500/503).

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

Ceník

Kreditové balíčky: 1 € za 1 000 požadavků, čerpají se po měsíční kvótě aktivního plánu, platnost 12 měsíců. Roční plány nesou objem jako měsíční kvótu účtovanou ročně.

Fakturace a správa klíčů

Klíče se vytvářejí a spravují z profilu; balíčky a předplatná se platí přes Stripe Checkout — samotné API se platebních dat nikdy nedotkne.