API-ul LeagueOfDataBase

Autentificare

Fiecare cerere /v1 poartă cheia ta — format lodb_ urmat de 40 de caractere hexazecimale — într-unul din două anteturi. Pe server se păstrează doar amprenta SHA-256: o cheie pierdută se regenerează, nu se recuperează.

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

URL de bază: https://api.league-of-data-base.com

Endpointuri

• GET/healthz

  Starea serviciului — singura rută fără autentificare.

• GET/v1/profiles/{username}

  Profilul public al unui membru: favorite și numărul de builduri publice (404 dacă profilul e privat).

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

  Buildurile publice ale unui campion (id Data Dragon), de la cel mai recent — paginat cu page și per_page (max. 50).

• GET/v1/trends/{type}

  Cele mai vizualizate entități ale site-ului: campioni, obiecte, rune sau vrăji de invocator — range=7d (implicit) sau 30d, top 25.

• GET/v1/usage

  Consumul în timp real al cheii apelante — autentificat și limitat în ritm, dar niciodată scăzut din cotă.

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
}

Cote și limitare de ritm

Fiecare cerere se impută întâi cotei lunare a planului, apoi creditelor preplătite; epuizate amândouă, API-ul răspunde 429 quota_exceeded.

Token bucket per cheie: fiecare răspuns /v1 poartă X-RateLimit-Limit, X-RateLimit-Remaining și X-RateLimit-Reset; peste limită, 429 rate_limited.

Cotele se resetează cu luna calendaristică. Planurile anuale poartă volumul drept cotă lunară (20 000 sau 60 000 de cereri pe lună).

Erori

Plic uniform la toate erorile. Coduri: unauthorized (401), forbidden (403, cheie revocată), 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" } }

Prețuri

Pachete de credite: 1 € la 1 000 de cereri, consumate după cota lunară a planului activ, valabile 12 luni. Planurile anuale poartă volumul drept cotă lunară, facturată anual.

Facturare și gestiunea cheilor

Cheile se creează și se gestionează din profilul tău; pachetele și abonamentele se plătesc prin Stripe Checkout — API-ul în sine nu atinge niciodată date de plată.