Primul apel, din limbajul tău.

1. Ia o cheie de sandbox

O cheie de sandbox e gratuită și nu cere un plan: o creezi din Chei API, în spațiul tău de lucru. Începe cu lv_test_, citește un singur joc — EuroMillions (EU-002), cel pe care îl apelează toate exemplele de mai jos — și rezultatele lui reale: ultimele 50, fiecare după ce are șapte zile. Are propria alocare de 1.000 de cereri pe zi și 60 pe minut, deci nu consumă niciodată cota planului tău.

Alt joc răspunde 403 lottery_not_entitled. Un rezultat mai nou decât întârzierea sau mai vechi decât ultimele 50 e refuzat după id cu 403 history_not_included; listele se opresc pur și simplu înaintea lui. GET /v1/account dă limitele în key.lottery_codes, key.history_until și plan.history_draws.

2. Instalează o bibliotecă

Fiecare e un client subțire, fără dependențe: fiecare endpoint e o metodă, răspunsul e JSON-ul decodat, iar un refuz aruncă o eroare cu code-ul stabil.

composer require lottevo/lottevo-php   # PHP 8.1+
npm install lottevo                    # Node 18+, Deno, Bun; cu tipuri TypeScript
pip install lottevo                    # Python 3.8+

3. Fă apelul

Pune cheia în LOTTEVO_API_KEY, apoi citește ultimele rezultate EuroMillions.

$lottevo = new Lottevo\Client(); // citește LOTTEVO_API_KEY

foreach ($lottevo->lotteries->draws('EU-002', ['per_page' => 5])['data'] as $draw) {
    echo $draw['drawn_at'], ' ', implode(' ', $draw['numbers']), PHP_EOL;
}

import { Client } from 'lottevo'

const lottevo = new Client() // citește LOTTEVO_API_KEY
const { data } = await lottevo.lotteries.draws('EU-002', { per_page: 5 })

from lottevo import Client

lottevo = Client()  # citește LOTTEVO_API_KEY
draws = lottevo.lotteries.draws("EU-002", {"per_page": 5})["data"]

Metodele urmează API-ul: lotteries.list, lotteries.get, lotteries.draws, draws.list, draws.latest, lotteries.check, webhooks.create și așa mai departe — referința le listează pe toate. Filtrele intră în query exact ca pe fir: { filter: { lottery: ['EU-002', 'RO-001'] } } se trimite ca filter[lottery]=EU-002,RO-001.

Paginare și erori

paginate() parcurge o listă până la capăt pornind de la prima pagină, urmând links.next:

for await (const lottery of lottevo.paginate(await lottevo.lotteries.list())) {
  console.log(lottery.code)
}

Un apel refuzat aruncă LottevoException (PHP) sau LottevoError (JavaScript, Python), cu status, code-ul stabil ($e->apiCode în PHP, unde getCode() e statusul HTTP), ID-ul cererii și, la un 429, cât să aștepți. Decide după code — vezi Erori.

Postman și OpenAPI

Fă fork la colecție din workspace-ul nostru public din Postman sau importă fișierul, apoi pune cheia în variabila apiKey și trimite. Toate cererile API-ului sunt acolo, grupate ca în referință, cu lottery setat pe EU-002.