Die LeagueOfDataBase-API

Authentifizierung

Jede /v1-Anfrage trägt deinen Schlüssel — Format lodb_ gefolgt von 40 Hexadezimalzeichen — in einem von zwei Headern. Serverseitig wird nur der SHA-256-Fingerabdruck gespeichert: ein verlorener Schlüssel wird neu erzeugt, nie wiederhergestellt.

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

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

Endpunkte

• GET/healthz

  Dienststatus — die einzige Route ohne Authentifizierung.

• GET/v1/profiles/{username}

  Öffentliches Profil eines Mitglieds: Favoriten und Anzahl öffentlicher Builds (404 bei privatem Profil).

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

  Öffentliche Builds eines Champions (Data-Dragon-Id), neueste zuerst — paginiert über page und per_page (max. 50).

• GET/v1/trends/{type}

  Meistbesuchte Entitäten der Seite: Champions, Items, Runen oder Beschwörerzauber — range=7d (Standard) oder 30d, Top 25.

• GET/v1/usage

  Live-Verbrauch des aufrufenden Schlüssels — authentifiziert und ratenlimitiert, aber nie vom Kontingent abgezogen.

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
}

Kontingente & Ratenlimit

Jede Anfrage wird zuerst dem Monatskontingent deines Tarifs, dann den vorausbezahlten Credits belastet; sind beide erschöpft, antwortet die API mit 429 quota_exceeded.

Token-Bucket pro Schlüssel: jede /v1-Antwort trägt X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset; darüber hinaus 429 rate_limited.

Kontingente setzen sich mit dem Kalendermonat zurück. Jahres-Tarife führen ihr Volumen als Monatskontingent (20 000 bzw. 60 000 Anfragen pro Monat).

Fehler

Einheitliche Hülle für alle Fehler. Codes: unauthorized (401), forbidden (403, widerrufener Schlüssel), not_found (404), rate_limited und quota_exceeded (429), invalid_request (400), internal (500/503).

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

Preise

Credit-Pakete: 1 € je 1 000 Anfragen, verbraucht nach dem Monatskontingent des aktiven Tarifs, 12 Monate gültig. Jahres-Tarife führen ihr Volumen als Monatskontingent, jährlich abgerechnet.

Abrechnung & Schlüsselverwaltung

Schlüssel werden im Profil erstellt und verwaltet; Pakete und Abonnements laufen über Stripe Checkout — die API selbst berührt niemals Zahlungsdaten.