واجهة 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)، من الأحدث إلى الأقدم — مقسّمة عبر 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
}

الحصص وحدّ المعدّل

يُحتسب كل طلب أولًا من الحصّة الشهرية لخطتك ثم من الأرصدة مسبقة الدفع؛ وعند نفاد الاثنين تردّ الواجهة بـ 429 quota_exceeded.

دلو رموز لكل مفتاح: كل استجابة /v1 تحمل X-RateLimit-Limit و X-RateLimit-Remaining و X-RateLimit-Reset؛ وفوق الحدّ 429 rate_limited.

تُعاد الحصص إلى الصفر مع الشهر الميلادي. الخطط السنوية تحمل حجمها كحصّة شهرية (20000 أو 60000 طلب شهريًا).

الأخطاء

غلاف موحّد لكل الأخطاء. الرموز: 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 € لكل 1000 طلب، تُستهلك بعد الحصّة الشهرية للخطة النشطة، صالحة 12 شهرًا. الخطط السنوية تحمل حجمها كحصّة شهرية وتُفوتر سنويًا.

الفوترة وإدارة المفاتيح

تُنشأ المفاتيح وتُدار من ملفك الشخصي؛ وتُدفع الحزم والاشتراكات عبر Stripe Checkout — الواجهة نفسها لا تلمس بيانات الدفع أبدًا.