L'API LeagueOfDataBase

Authentification

Chaque requête /v1 porte votre clé — format lodb_ suivi de 40 caractères hexadécimaux — dans l'un des deux en-têtes. Seule son empreinte SHA-256 est stockée côté serveur : une clé perdue se régénère, elle ne se récupère pas.

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

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

Endpoints

• GET/healthz

  État du service — la seule route sans authentification.

• GET/v1/profiles/{username}

  Profil public d'un membre : favoris et nombre de builds publics (404 si le profil est privé).

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

  Builds publics d'un champion (id Data Dragon), du plus récent au plus ancien — paginé via page et per_page (max 50).

• GET/v1/trends/{type}

  Entités les plus consultées du site : champions, objets, runes ou sorts d'invocateur — range=7d (défaut) ou 30d, top 25.

• GET/v1/usage

  Consommation en direct de la clé appelante — authentifiée et soumise au débit, mais jamais décomptée du 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
}

Quotas & limitation de débit

Chaque requête est imputée au quota mensuel de votre offre, puis aux crédits prépayés ; les deux épuisés, l'API répond 429 quota_exceeded.

Token bucket par clé : chaque réponse /v1 porte X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset ; au-delà, 429 rate_limited.

Les quotas se réinitialisent au mois calendaire. Les offres annuelles portent leur volume en quota mensuel (20 000 ou 60 000 requêtes par mois).

Erreurs

Enveloppe uniforme sur toutes les erreurs. Codes : unauthorized (401), forbidden (403, clé révoquée), not_found (404), rate_limited et quota_exceeded (429), invalid_request (400), internal (500/503).

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

Tarifs

Packs de crédits : 1 € les 1 000 requêtes, consommées après le quota mensuel de l'offre active, valables 12 mois. Les offres annuelles portent leur volume en quota mensuel, facturé à l'année.

Facturation & gestion des clés

Les clés se créent et se gèrent depuis votre profil ; packs et abonnements se règlent via Stripe Checkout — l'API elle-même ne manipule jamais de données de paiement.