API LeagueOfDataBase

Аутентификация

Каждый запрос /v1 несёт ваш ключ — формат lodb_ и 40 шестнадцатеричных символов — в одном из двух заголовков. На сервере хранится только отпечаток SHA-256: потерянный ключ перевыпускается, а не восстанавливается.

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

Базовый URL: https://api.league-of-data-base.com

Эндпоинты

• GET/healthz

  Состояние сервиса — единственный маршрут без аутентификации.

• GET/v1/profiles/{username}

  Публичный профиль участника: избранное и число публичных сборок (404, если профиль приватный).

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

  Публичные сборки чемпиона (id Data Dragon), от новых к старым — пагинация через page и per_page (макс. 50).

• GET/v1/trends/{type}

  Самые просматриваемые сущности сайта: чемпионы, предметы, руны или заклинания призывателя — range=7d (по умолчанию) или 30d, топ-25.

• GET/v1/usage

  Текущий расход вызывающего ключа — с аутентификацией и лимитом частоты, но никогда не списывается с квоты.

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
}

Квоты и ограничение частоты

Каждый запрос списывается сначала с месячной квоты плана, затем с предоплаченных кредитов; когда исчерпано и то и другое, API отвечает 429 quota_exceeded.

Token bucket на ключ: каждый ответ /v1 несёт X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset; сверх лимита — 429 rate_limited.

Квоты обнуляются с календарным месяцем. Годовые планы несут объём как месячную квоту (20 000 или 60 000 запросов в месяц).

Ошибки

Единый конверт для всех ошибок. Коды: unauthorized (401), forbidden (403, отозванный ключ), not_found (404), rate_limited и quota_exceeded (429), invalid_request (400), internal (500/503).

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

Цены

Пакеты кредитов: 1 € за 1 000 запросов, расходуются после месячной квоты активного плана, действуют 12 месяцев. Годовые планы несут объём как месячную квоту с оплатой за год.

Оплата и управление ключами

Ключи создаются и управляются из профиля; пакеты и подписки оплачиваются через Stripe Checkout — само API никогда не касается платёжных данных.