A API do LeagueOfDataBase

Autenticação

Cada requisição /v1 leva sua chave — formato lodb_ seguido de 40 caracteres hexadecimais — em um de dois cabeçalhos. No servidor só é guardada sua impressão SHA-256: uma chave perdida se regenera, nunca se recupera.

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

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

Endpoints

• GET/healthz

  Estado do serviço — a única rota sem autenticação.

• GET/v1/profiles/{username}

  Perfil público de um membro: favoritos e número de builds públicas (404 se o perfil for privado).

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

  Builds públicas de um campeão (id do Data Dragon), da mais recente — paginado com page e per_page (máx. 50).

• GET/v1/trends/{type}

  Entidades mais consultadas do site: campeões, itens, runas ou feitiços de invocador — range=7d (padrão) ou 30d, top 25.

• GET/v1/usage

  Consumo ao vivo da chave chamadora — autenticado e com limite de taxa, mas nunca descontado da cota.

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
}

Cotas e limite de taxa

Cada requisição é debitada da cota mensal do seu plano e depois dos créditos pré-pagos; esgotados os dois, a API responde 429 quota_exceeded.

Token bucket por chave: cada resposta /v1 traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset; acima do limite, 429 rate_limited.

As cotas reiniciam com o mês do calendário. Os planos anuais carregam seu volume como cota mensal (20 000 ou 60 000 requisições por mês).

Erros

Envelope uniforme em todos os erros. Códigos: unauthorized (401), forbidden (403, chave revogada), 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" } }

Preços

Pacotes de créditos: 1 € a cada 1 000 requisições, gastas após a cota mensal do plano ativo, válidas por 12 meses. Os planos anuais carregam seu volume como cota mensal, cobrada por ano.

Cobrança e gestão de chaves

As chaves são criadas e geridas no seu perfil; pacotes e assinaturas são pagos via Stripe Checkout — a própria API nunca toca em dados de pagamento.