Prima ta cerere de date despre loterii.

Date despre loterii printr-un API REST versionat: catalogul de jocuri, programul lor, fiecare rezultat pe care l-am înregistrat, până unde ajunge planul tău, categoriile de premii publicate, tabelele de câștiguri cu cote fixe și statisticile istorice ale numerelor — livrate la cerere, prin webhook sau printr-un flux live de evenimente.

1. Creează o cheie API

Creează o cheie din spațiul de lucru, cu permisiunile și loteriile de care are nevoie aplicația ta. Păstreaz-o pe server și în afara controlului versiunilor — cheia completă se afișează o singură dată.

2. Trimite o cerere

curl https://api.lottevo.com/v1/lotteries/EU-002/draws \
  -H 'Authorization: Bearer lv_a1b2c3d4e5f6_…' \
  -H 'Accept: application/json'

const response = await fetch('https://api.lottevo.com/v1/lotteries/EU-002/draws', {
  headers: { 'X-Api-Key': process.env.LOTTEVO_API_KEY, Accept: 'application/json' },
})

const { data, meta, links } = await response.json()

GET /v1/account este testul de verificare rapidă. Nu cere nicio permisiune și răspunde cu planul cheii, permisiunile ei, loteriile din catalog la care are acces și ce a consumat contul azi.

3. Citește răspunsul

Rezultatele sunt incluse în data. Colecțiile adaugă links și meta pentru paginarea cu cursor. Această extragere prescurtată arată câmpurile de care o interfață are de obicei nevoie:

{
  "data": [{
    "lottery_code": "EU-002",
    "numbers": [4, 7, 12, 31, 44],
    "bonus_numbers": [8, 11],
    "currency": "EUR",
    "drawn_at": "2026-09-29T19:45:00+00:00",
    "prizes_status": "published"
  }]
}

Ce limitează o cheie

Patru lucruri, și merită să știi care dintre ele te-a refuzat:

• Permisiunile — ce poate citi sau gestiona cheia. Una lipsă înseamnă 403 insufficient_scope.
• Limitele de cereri — pe minut la orice plan, pe zi UTC la cele contorizate. 429.
• Accesul la catalog — jocurile pe care le acoperă cheia. Un joc din afara lui înseamnă 403 lottery_not_entitled, nu 404: jocul există, evident.
• Adâncimea istoricului — cât de departe în trecut ajunge planul tău; history_from din GET /v1/account arată de unde începe. Listele se opresc pur și simplu acolo, iar un rezultat mai vechi cerut după ID înseamnă 403 history_not_included.

Ce urmează