L'API di LeagueOfDataBase

Autenticazione

Ogni richiesta /v1 porta la tua chiave — formato lodb_ seguito da 40 caratteri esadecimali — in una delle due intestazioni. Sul server si conserva solo l'impronta SHA-256: una chiave persa si rigenera, non si recupera.

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

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

Endpoint

• GET/healthz

  Stato del servizio — l'unica rotta senza autenticazione.

• GET/v1/profiles/{username}

  Profilo pubblico di un membro: preferiti e numero di build pubbliche (404 se il profilo è privato).

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

  Build pubbliche di un campione (id Data Dragon), dalla più recente — paginato con page e per_page (max 50).

• GET/v1/trends/{type}

  Entità più consultate del sito: campioni, oggetti, rune o incantesimi dell'evocatore — range=7d (predefinito) o 30d, top 25.

• GET/v1/usage

  Consumo in tempo reale della chiave chiamante — autenticato e con limite di frequenza, ma mai contato nella quota.

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
}

Quote e limite di frequenza

Ogni richiesta è imputata alla quota mensile del tuo piano, poi ai crediti prepagati; esauriti entrambi, l'API risponde 429 quota_exceeded.

Token bucket per chiave: ogni risposta /v1 porta X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset; oltre il limite, 429 rate_limited.

Le quote si azzerano con il mese di calendario. I piani annuali portano il loro volume come quota mensile (20 000 o 60 000 richieste al mese).

Errori

Busta uniforme su tutti gli errori. Codici: unauthorized (401), forbidden (403, chiave revocata), not_found (404), rate_limited e quota_exceeded (429), invalid_request (400), internal (500/503).

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

Prezzi

Pacchetti di crediti: 1 € ogni 1 000 richieste, spese dopo la quota mensile del piano attivo, valide 12 mesi. I piani annuali portano il loro volume come quota mensile, fatturata all'anno.

Fatturazione e gestione delle chiavi

Le chiavi si creano e si gestiscono dal tuo profilo; pacchetti e abbonamenti si pagano con Stripe Checkout — l'API in sé non tocca mai dati di pagamento.