API LeagueOfDataBase

Autentikasi

Setiap permintaan /v1 membawa kuncimu — format lodb_ diikuti 40 karakter heksadesimal — di salah satu dari dua header. Server hanya menyimpan sidik jari SHA-256-nya: kunci yang hilang dibuat ulang, tidak pernah dipulihkan.

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

URL dasar: https://api.league-of-data-base.com

Endpoint

• GET/healthz

  Status layanan — satu-satunya rute tanpa autentikasi.

• GET/v1/profiles/{username}

  Profil publik seorang anggota: favorit dan jumlah build publik (404 jika profil privat).

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

  Build publik sebuah champion (id Data Dragon), dari terbaru — dipaginasi lewat page dan per_page (maks. 50).

• GET/v1/trends/{type}

  Entitas paling banyak dilihat di situs: champion, item, rune, atau summoner spell — range=7d (bawaan) atau 30d, 25 teratas.

• GET/v1/usage

  Pemakaian langsung kunci pemanggil — terautentikasi dan dibatasi laju, tapi tidak pernah dihitung ke kuota.

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
}

Kuota & batas laju

Tiap permintaan dibebankan dulu ke kuota bulanan paketmu, lalu ke kredit prabayar; jika keduanya habis, API menjawab 429 quota_exceeded.

Token bucket per kunci: tiap respons /v1 membawa X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset; melebihi batas, 429 rate_limited.

Kuota direset mengikuti bulan kalender. Paket tahunan membawa volumenya sebagai kuota bulanan (20.000 atau 60.000 permintaan per bulan).

Kesalahan

Amplop seragam di semua kesalahan. Kode: unauthorized (401), forbidden (403, kunci dicabut), not_found (404), rate_limited dan quota_exceeded (429), invalid_request (400), internal (500/503).

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

Harga

Paket kredit: 1 € per 1.000 permintaan, dipakai setelah kuota bulanan paket aktif, berlaku 12 bulan. Paket tahunan membawa volumenya sebagai kuota bulanan, ditagih per tahun.

Penagihan & pengelolaan kunci

Kunci dibuat dan dikelola dari profilmu; paket dan langganan dibayar lewat Stripe Checkout — API-nya sendiri tidak pernah menyentuh data pembayaran.