La API de LeagueOfDataBase

Autenticación

Cada petición /v1 lleva tu clave — formato lodb_ seguido de 40 caracteres hexadecimales — en una de dos cabeceras. En el servidor solo se guarda su huella SHA-256: una clave 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 del servicio — la única ruta sin autenticación.

• GET/v1/profiles/{username}

  Perfil público de un miembro: favoritos y número de builds públicas (404 si el perfil es privado).

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

  Builds públicas de un campeón (id de Data Dragon), de la más reciente a la más antigua — paginado con page y per_page (máx. 50).

• GET/v1/trends/{type}

  Entidades más consultadas del sitio: campeones, objetos, runas o hechizos de invocador — range=7d (por defecto) o 30d, top 25.

• GET/v1/usage

  Consumo en vivo de la clave llamante — autenticado y con límite de ritmo, pero nunca descontado de la cuota.

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
}

Cuotas y límite de ritmo

Cada petición se imputa a la cuota mensual de tu plan y después a los créditos prepagados; agotados ambos, la API responde 429 quota_exceeded.

Token bucket por clave: cada respuesta /v1 lleva X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset; por encima del límite, 429 rate_limited.

Las cuotas se reinician con el mes natural. Los planes anuales llevan su volumen como cuota mensual (20 000 o 60 000 peticiones al mes).

Errores

Envoltura uniforme en todos los errores. Códigos: unauthorized (401), forbidden (403, clave revocada), not_found (404), rate_limited y quota_exceeded (429), invalid_request (400), internal (500/503).

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

Precios

Packs de créditos: 1 € por cada 1 000 peticiones, gastadas tras la cuota mensual del plan activo, válidas 12 meses. Los planes anuales llevan su volumen como cuota mensual, facturada al año.

Facturación y gestión de claves

Las claves se crean y gestionan desde tu perfil; packs y suscripciones se pagan con Stripe Checkout — la API en sí nunca toca datos de pago.