Ghiduri de integrare
Rezultatele pe site-ul tău, dintr-un snippet.
Include pe orice site al tău ultimele rezultate și jackpoturile anunțate ale jocurilor pe care le alegi — stilizate ca el, cu înălțimea potrivită conținutului, cu cel mult un minut întârziere la încărcarea paginii.
Un widget este o pagină mică servită de API și afișată într-un iframe. Listează jocurile pe care
le numești, fiecare cu ultimele numere, data următoarei extrageri și jackpotul anunțat pentru ea.
Vizitatorii ajung cu un clic pe pagina jocului de pe Lottevo. Nimic de găzduit, nimic de ținut la zi.
Înainte să începi
Un widget rulează sub una dintre cheile tale API și poate fi afișat doar pe site-urile permise de acea cheie:
- În Chei API, creează o cheie doar cu permisiuni de citire și adaugă
site-ul ca origine permisă — schema și gazda, de exemplu
https://example.com. Adaugă fiecare adresă de pe care e servit (https://www.example.come altă origine). - Deschide Widget-uri, alege cheia și jocurile și copiază snippetul. Previzualizarea arată exact ce vor vedea vizitatorii.
Originile le aplică browserul însuși: widgetul răspunde cu o politică frame-ancestors care le
listează, deci nu poate fi inclus în altă parte.
Snippetul
<div data-lottevo-widget data-key="lv_a1b2c3d4e5f6" data-lotteries="EU-002,RO-001"></div>
<script src="https://api.lottevo.com/widgets/embed.js" async></script>
data-key este id-ul public al cheii — lv_ și prefixul ei, fără secret. Cheia completă nu
trebuie să apară niciodată într-o pagină; un widget care o conține e refuzat cu
widget_secret_exposed, iar cheia trebuie înlocuită. Un singur tag script servește oricâte
widget-uri din pagină, iar fiecare cadru își potrivește înălțimea după conținut.
| Atribut | Valori | Implicit |
|---|---|---|
data-key | id-ul public al cheii | obligatoriu |
data-lotteries | coduri de loterie, separate prin virgulă, până la 12, în ordinea afișării | obligatoriu |
data-theme | auto, light, dark | auto (după sistemul vizitatorului) |
data-accent | o culoare hex fără #, de exemplu 2563eb | albastrul Lottevo |
data-locale | en, ro | limba browserului vizitatorului |
data-badge | 0 ascunde insigna „Rezultate de la Lottevo”, de la planul Pro | afișată |
data-order | drawn, ascending — jocurile de cifre și cele trase din mai multe urne rămân mereu în ordinea extragerii | drawn (ordinea extragerii) |
Fără JavaScript, pune un iframe direct pe pagină — primește aceiași parametri, fără prefixul
data-:
<iframe src="https://api.lottevo.com/widgets/results?key=lv_a1b2c3d4e5f6&lotteries=EU-002,RO-001"
width="100%" height="320" style="border:0" title="Rezultate loterie"></iframe>
Ce jocuri
Jocurile pe care cheia le poate citi: pe un plan cu o selecție de jocuri, doar acelea; un joc din afara ei e lăsat pe dinafară. Un cont fără plan își păstrează widget-urile, fără jocurile cu extrageri dese (Keno și similare).
Afișări și planuri
Fiecare afișare a unui widget contează ca o afișare, pentru tot contul și toate cheile lui, pe zi UTC. Afișările nu sunt cereri API: nu ating cota de cereri și nici alertele ei.
| Plan | Afișări pe zi | Insignă |
|---|---|---|
| Fără plan | 1.000 | mereu afișată |
| Perioadă de probă | 1.000 | afișată |
| Developer | 10.000 | afișată |
| Starter | 50.000 | afișată |
| Pro | 500.000 | poate fi ascunsă |
| Enterprise | nelimitat | poate fi ascunsă |
După plafonul zilei, widgetul afișează un scurt mesaj până la miezul nopții UTC. Dashboard-ul îți arată afișările zilei și pe cele refuzate. Cardul fiecărui joc stă în cache un minut, deci un rezultat ajunge în widget la cel mult un minut după ce ajunge în API.
Mesaje
Când un widget nu poate fi afișat, cadrul arată în locul lui un mesaj cu un cod:
| HTTP | code | Semnificație |
|---|---|---|
| 403 | widget_origins_required | Cheia nu are origini permise, deci nu poate fi inclusă |
| 404 | widget_key_invalid | Cheie necunoscută, revocată sau expirată |
| 404 | widget_no_lotteries | Niciunul dintre jocurile numite nu poate fi afișat cu această cheie |
| 422 | widget_invalid | Un parametru lipsește sau e greșit; mesajul îl numește |
| 422 | widget_secret_exposed | Snippetul conține cheia completă: folosește id-ul public și înlocuiește cheia |
| 429 | widget_views_exceeded | Widget-urile contului au consumat afișările zilei |