LeagueOfDataBase API

身分驗證

每個 /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

  某英雄(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 本身絕不接觸付款資料。