LeagueOfDataBase API

인증

모든 /v1 요청은 lodb_ 뒤에 16진수 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

  챔피언(Data Dragon id)의 공개 빌드, 최신순 — 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를 반환합니다.

키별 토큰 버킷: 모든 /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,000회당 1 €, 활성 플랜의 월 할당량 소진 후 사용, 유효기간 12개월. 연간 플랜은 물량을 월 할당량으로 적용하며 연 단위로 청구됩니다.

결제 및 키 관리

키는 프로필에서 생성·관리합니다. 팩과 구독은 Stripe Checkout으로 결제하며 API 자체는 결제 데이터를 다루지 않습니다.