API LeagueOfDataBase

Uwierzytelnianie

Każde zapytanie /v1 niesie twój klucz — format lodb_ i 40 znaków szesnastkowych — w jednym z dwóch nagłówków. Po stronie serwera trzymany jest tylko odcisk SHA-256: zgubiony klucz generuje się ponownie, nie odzyskuje.

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

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

Endpointy

• GET/healthz

  Stan usługi — jedyna trasa bez uwierzytelniania.

• GET/v1/profiles/{username}

  Publiczny profil członka: ulubione i liczba publicznych buildów (404, gdy profil jest prywatny).

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

  Publiczne buildy bohatera (id Data Dragon), od najnowszych — stronicowane przez page i per_page (maks. 50).

• GET/v1/trends/{type}

  Najczęściej oglądane byty serwisu: bohaterowie, przedmioty, runy lub czary przywoływacza — range=7d (domyślnie) lub 30d, top 25.

• GET/v1/usage

  Bieżące zużycie wywołującego klucza — uwierzytelnione i limitowane, ale nigdy nie liczone do limitu.

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
}

Limity i tempo zapytań

Każde zapytanie obciąża najpierw miesięczny limit planu, potem przedpłacone kredyty; po wyczerpaniu obu API odpowiada 429 quota_exceeded.

Token bucket na klucz: każda odpowiedź /v1 niesie X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset; powyżej limitu 429 rate_limited.

Limity zerują się z miesiącem kalendarzowym. Plany roczne niosą swój wolumen jako limit miesięczny (20 000 lub 60 000 zapytań miesięcznie).

Błędy

Jednolita koperta dla wszystkich błędów. Kody: unauthorized (401), forbidden (403, klucz unieważniony), not_found (404), rate_limited i quota_exceeded (429), invalid_request (400), internal (500/503).

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

Cennik

Pakiety kredytów: 1 € za 1 000 zapytań, zużywane po miesięcznym limicie aktywnego planu, ważne 12 miesięcy. Plany roczne niosą swój wolumen jako limit miesięczny, rozliczany rocznie.

Rozliczenia i zarządzanie kluczami

Klucze tworzy się i zarządza nimi z profilu; pakiety i subskrypcje opłacane są przez Stripe Checkout — samo API nigdy nie dotyka danych płatniczych.