Το API του LeagueOfDataBase

Πιστοποίηση

Κάθε αίτημα /v1 φέρει το κλειδί σας — μορφή lodb_ ακολουθούμενη από 40 δεκαεξαδικούς χαρακτήρες — σε μία από δύο κεφαλίδες. Στον διακομιστή αποθηκεύεται μόνο το αποτύπωμα SHA-256: ένα χαμένο κλειδί αναδημιουργείται, δεν ανακτάται ποτέ.

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

Βασικό URL: https://api.league-of-data-base.com

Endpoints

• GET/healthz

  Κατάσταση υπηρεσίας — η μόνη διαδρομή χωρίς πιστοποίηση.

• GET/v1/profiles/{username}

  Δημόσιο προφίλ μέλους: αγαπημένα και αριθμός δημόσιων builds (404 αν το προφίλ είναι ιδιωτικό).

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

  Δημόσια 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 δεν αγγίζει ποτέ δεδομένα πληρωμών.