API ของ LeagueOfDataBase

การยืนยันตัวตน

ทุกคำขอ /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

  บิลด์สาธารณะของแชมเปียน (id ของ Data Dragon) เรียงจากใหม่สุด — แบ่งหน้าโดย 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

Token bucket ต่อคีย์: ทุกการตอบกลับ /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 € ต่อ 1,000 คำขอ ใช้หลังโควตารายเดือนของแพ็กเกจที่ใช้งานหมด มีอายุ 12 เดือน แพ็กเกจรายปีถือปริมาณเป็นโควตารายเดือนและเรียกเก็บเป็นรายปี

การเรียกเก็บเงินและการจัดการคีย์

สร้างและจัดการคีย์ได้จากโปรไฟล์ของคุณ แพ็กและการสมัครชำระผ่าน Stripe Checkout — ตัว API เองไม่แตะข้อมูลการชำระเงินเลย