LeagueOfDataBase API

認証

すべての /v1 リクエストは、lodb_ に16進数40文字が続く形式のキーを、2つのヘッダーのいずれかで送ります。サーバー側には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自体が決済データに触れることはありません。