开发者

LeagueOfDataBase API

一个基于站点社区数据的 REST JSON 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" } }

价格

方案	价格	额度	速率限制
免费	0 €	每月 500 次	每分钟 10 次
积分包 S	5 €	5 000 次请求	每分钟 60 次
积分包 M	10 €	10 000 次请求	每分钟 60 次
积分包 L	20 €	20 000 次请求	每分钟 60 次
月付	5 €/月	每月 15 000 次	每分钟 120 次
月付+	15 €/月	每月 45 000 次	每分钟 120 次
年付	48 €/年	每月 20 000 次	每分钟 300 次
年付+	144 €/年	每月 60 000 次	每分钟 300 次

积分包:每 1,000 次请求 1 €,在当前方案的月度配额用尽后消耗,有效期 12 个月。年付方案按月度配额承载额度,按年计费。

计费与密钥管理

密钥在个人资料中创建与管理;积分包与订阅通过 Stripe Checkout 支付 — API 本身绝不接触支付数据。

创建我的密钥