API của LeagueOfDataBase

Xác thực

Mỗi yêu cầu /v1 mang khóa của bạn — định dạng lodb_ theo sau là 40 ký tự thập lục phân — trong một trong hai header. Máy chủ chỉ lưu dấu vân tay SHA-256: khóa mất chỉ được tạo lại, không bao giờ khôi phục.

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

URL gốc: https://api.league-of-data-base.com

Endpoint

• GET/healthz

  Tình trạng dịch vụ — tuyến duy nhất không cần xác thực.

• GET/v1/profiles/{username}

  Hồ sơ công khai của một thành viên: mục yêu thích và số build công khai (404 nếu hồ sơ riêng tư).

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

  Các build công khai của một tướng (id Data Dragon), mới nhất trước — phân trang bằng page và per_page (tối đa 50).

• GET/v1/trends/{type}

  Các mục được xem nhiều nhất trên trang: tướng, trang bị, ngọc bổ trợ hoặc phép triệu hồi — range=7d (mặc định) hoặc 30d, top 25.

• GET/v1/usage

  Mức dùng trực tiếp của khóa gọi — có xác thực và giới hạn tốc độ, nhưng không bao giờ tính vào hạn mức.

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
}

Hạn mức & giới hạn tốc độ

Mỗi yêu cầu được tính trước vào hạn mức tháng của gói, rồi đến tín dụng trả trước; hết cả hai, API trả về 429 quota_exceeded.

Token bucket theo khóa: mỗi phản hồi /v1 mang X-RateLimit-Limit, X-RateLimit-Remaining và X-RateLimit-Reset; vượt giới hạn, 429 rate_limited.

Hạn mức đặt lại theo tháng dương lịch. Gói năm mang dung lượng dưới dạng hạn mức tháng (20.000 hoặc 60.000 yêu cầu mỗi tháng).

Lỗi

Phong bì thống nhất cho mọi lỗi. Mã: unauthorized (401), forbidden (403, khóa bị thu hồi), not_found (404), rate_limited và quota_exceeded (429), invalid_request (400), internal (500/503).

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

Bảng giá

Gói tín dụng: 1 € cho mỗi 1.000 yêu cầu, dùng sau hạn mức tháng của gói đang hoạt động, hiệu lực 12 tháng. Gói năm mang dung lượng dưới dạng hạn mức tháng, tính phí theo năm.

Thanh toán & quản lý khóa

Khóa được tạo và quản lý từ trang cá nhân; gói và thuê bao thanh toán qua Stripe Checkout — bản thân API không bao giờ chạm vào dữ liệu thanh toán.