Sari la conținut

Referință API

Un contract clar pentru produsul tău.

De la primul rezultat până la cea mai recentă corectură.

38 de operații în versiunea v1. Fiecare cale de mai jos începe cu https://api.lottevo.com. Căile, rezumatele și răspunsurile sunt generate din documentul OpenAPI al API-ului, așa că nu se pot îndepărta de cod.

38 endpoint-uri

Catalog

GET/v1/lotteriesCatalog · catalog:read

Catalogul. Jocurile inactive nu sunt listate

Încearcă
ParametruLocDescriere
filter[q]queryText liber, căutat în cod și în fiecare nume tradus.
filter[continent]queryCodul continentului, de exemplu EU.
filter[country]queryCodul țării, de exemplu RO.
filter[state]queryCodul statului. Câștigă locația cea mai specifică.
sortqueryposition, code, next_draw_at, started_at. Pune - în față pentru ordine inversă.
includequeryschedules, latest_draw, draws, payouts, assets, availability, separate prin virgulă.
per_pagequeryDimensiunea paginii, cel mult 25. Poate doar să micșoreze o pagină.
cursorqueryCursorul din links.next. Nu există paginare cu offset.

Răspunsuri200 Set paginat de `LotteryResource`

GET/v1/lotteries/{lottery}Catalog · catalog:read

Un joc, adresat după cod — plus ultimele lui rezultate și tabelul de câștiguri, care sunt ieftine pentru un singur joc și sunt exact ce arată pagina unui joc

Încearcă
ParametruLocDescriere
lotterypathCodul loteriei

Răspunsuri200 `LotteryResource`404

GET/v1/lotteries/{lottery}/scheduleCatalog · catalog:read

Când are loc extragerea unui joc: fiecare program scris în limba cererii, plus următoarele câteva apariții deja convertite în momente UTC, ca un client să nu trebuiască să gestioneze ora de vară ca să construiască un calendar

Încearcă

regular este false pentru un joc care se extrage în zile neregulate, cum ar fi unul legat de calendarul curselor de cai: nu are orar, așa că programele, următoarea extragere și aparițiile viitoare sunt goale.

ParametruLocDescriere
lotterypathCodul loteriei
occurrencesqueryCâte extrageri viitoare să fie calculate, cel mult 25.

Răspunsuri200 404

GET/v1/lotteries/{lottery}/payoutsCatalog · catalog:read

Tabelul de câștiguri al unui joc cu cote fixe

Încearcă

Unele jocuri nu împart un fond între câștigători: premiul depinde de bilet — pe ce s-a pariat, câte numere s-au jucat, câte s-au potrivit —, deci este același la fiecare extragere și se publică aici, nu odată cu fiecare rezultat. Un joc care împarte un fond întoarce o listă goală; sumele lui sunt la extrageri.

ParametruLocDescriere
lotterypathCodul loteriei

Răspunsuri200 Listă de `LotteryPayoutResource`404

GET/v1/continentsCatalog · catalog:read

Continentele care au cel puțin o loterie. Nepaginat intenționat: sunt doar câteva, iar un client care construiește o listă derulantă nu ar trebui să urmeze un cursor pentru ea

Încearcă

Răspunsuri200 Listă de `ContinentResource`

GET/v1/countriesCatalog · catalog:read

Țările care au cel puțin o loterie, opțional în cadrul unui singur continent. Listează atât țările cărora le aparțin jocuri, cât și pe cele în care se vând jocuri, așa că Ciprul apare pentru jocurile grecești

Încearcă

Răspunsuri200 Listă de `CountryResource`

GET/v1/statesCatalog · catalog:read

Statele care au cel puțin o loterie, opțional în cadrul unei singure țări

Încearcă

Răspunsuri200 Listă de `StateResource`

GET/v1/complianceCatalog · catalog:read

Cadrul legal al fiecărei jurisdicții documentate, opțional în cadrul unei singure țări

Încearcă

Țările și statele sau provinciile lor vin într-o singură listă, fiecare țară urmată de statele ei. Un stat american are nivelul federal de impozitare alături de al său, așa că poate fi citit separat.

Răspunsuri200 Listă de `JurisdictionComplianceResource`

GET/v1/lotteries/{lottery}/complianceCatalog · catalog:read

Cadrul legal al fiecărei jurisdicții în care se vinde o loterie

Încearcă

Un joc național își listează doar țara: nu se știe pentru fiecare joc ce state sau provincii îl vând, iar intrarea țării spune când regulile diferă între ele.

ParametruLocDescriere
lotterypathCodul loteriei

Răspunsuri200 Listă de `JurisdictionComplianceResource`404

Rezultatele extragerilor

GET/v1/drawsExtrageri · draws:read

Lista de rezultate, cele mai noi primele, pentru tot catalogul sau restrâns la un joc, o țară sau un interval de date. Cursorul este reperul după care un client se resincronizează; o pagină cu offset ar fi deplasată de fiecare extragere care sosește în timpul citirii. Rezultatele mai vechi decât istoricul inclus în planul tău nu sunt listate — /v1/account îți dă începutul exact

Încearcă
ParametruLocDescriere
filter[lottery]queryCoduri de loterie, separate prin virgulă.
filter[continent]queryCodul continentului, de exemplu EU.
filter[country]queryCodul țării, de exemplu RO.
filter[state]queryCodul statului. Câștigă locația cea mai specifică.
filter[from]queryLimita inferioară inclusivă pentru drawn_at, un moment ISO-8601 interpretat ca UTC.
filter[to]queryLimita superioară inclusivă pentru drawn_at.
sortquerydrawn_at sau scheduled_at. Implicit -drawn_at.
includequeryprizes — categoriile de premii, doar la cerere, pentru că o pagină cu ele este mare.
per_pagequeryDimensiunea paginii, cel mult 25. Poate doar să micșoreze o pagină.
cursorqueryCursorul din links.next. Nu există paginare cu offset.

Răspunsuri200 Set paginat de `DrawResource`

GET/v1/draws/latestExtrageri · draws:read

Rezultatul curent al fiecărui joc — tabloul pe care îl afișează un panou

Încearcă

Ultimul rezultat al fiecărui joc, paginat după jocuri: fiecare pagină are o singură intrare pe joc, așa că un joc cu extrageri dese nu ia niciodată locul unuia cu extrageri săptămânale.

ParametruLocDescriere
filter[continent]queryCodul continentului, de exemplu EU.
filter[country]queryCodul țării, de exemplu RO.
filter[state]queryCodul statului. Câștigă locația cea mai specifică.
per_pagequeryDimensiunea paginii, cel mult 25. Poate doar să micșoreze o pagină.
cursorqueryCursorul din links.next. Nu există paginare cu offset.

Răspunsuri200 Set paginat de `LotteryResource`

GET/v1/draws/{draw}Extrageri · draws:read

Un rezultat după ID. ID-urile sunt stabile, iar acesta este URL-ul la care trimite înapoi payload-ul unui webhook. Un rezultat mai vechi decât istoricul inclus în planul tău este refuzat cu history_not_included

Încearcă
ParametruLocDescriere
drawpathID-ul extragerii

Răspunsuri200 `DrawResource`404

GET/v1/lotteries/{lottery}/drawsExtrageri · draws:read

Istoricul rezultatelor unui joc, cele mai noi primele, cât de departe în trecut include planul tău (vezi /v1/account). Fiecare pagină răspunde la fel de repede, oricât de adânc ai merge înapoi

Încearcă

Besides the dates, filter[numbers]=7,23 keeps the draws whose main numbers include all of those, filter[weekday]=7 the draws held on a weekday (1 = Monday, 7 = Sunday, on the game's local clock; several separated by commas), and filter[jackpot_won]=true the draws whose top prize was won (false: published without a winner).

ParametruLocDescriere
lotterypathCodul loteriei
filter[from]queryLimita inferioară inclusivă pentru drawn_at.
filter[to]queryLimita superioară inclusivă pentru drawn_at.
sortquerydrawn_at sau scheduled_at. Implicit -drawn_at.
per_pagequeryDimensiunea paginii, cel mult 25. Poate doar să micșoreze o pagină.
cursorqueryCursorul din links.next. Nu există paginare cu offset.

Răspunsuri200 Set paginat de `DrawResource`404

Verificarea biletelor

GET/v1/lotteries/{lottery}/checkExtrageri · draws:read

Verifică un bilet în istoricul unui joc

Încearcă

Trimite biletul ca numbers=3,11,17,24,38,45 — plus bonus=7 pentru un joc al cărui număr bonus se joacă separat — și primești fiecare extragere trecută cu care s-a potrivit, cele mai noi primele. La un joc cu numere, o extragere este listată când a conținut cel puțin min_matched dintre numere; la un joc cu cifre (Pick 3, Joker, …) când a fost o potrivire exactă sau în orice ordine, ori a potrivit cel puțin min_matched cifre pe poziție sau consecutiv de la oricare capăt. meta.summary numără fiecare rezultat posibil pe toată fereastra, iar pentru un joc al cărui operator publică premiile la fiecare extragere meta.winnings adună ce ar fi câștigat biletul, pe monedă, la sumele plătite atunci per câștigător — brut, așa cum au fost publicate; complete este false când unele extrageri nu au putut fi evaluate. Fereastra este range (3months, 6months, 1year, 2years, all) sau from/to și nu ajunge niciodată înainte ca jocul să aibă formatul actual și nici mai departe decât include planul tău (meta.window). Inclus în toate planurile și în perioada de probă.

ParametruLocDescriere
lotterypathCodul loteriei
numbersqueryNumerele biletului, separate prin virgulă. Jocurile cu cifre primesc o cifră pe poziție.
bonusqueryNumerele bonus jucate separat, unde jocul le are.
min_matchedqueryListează doar extragerile cu cel puțin atâtea potriviri. Implicit jumătate din bilet.
rangequery3months, 6months, 1year, 2years sau all. Se folosește fie acesta, fie from/to, nu amândouă.
fromqueryVerifică începând cu acest moment. Istoricul depinde și de planul tău.
toqueryVerifică până la acest moment.
per_pagequeryDimensiunea paginii, cel mult 25. Poate doar să micșoreze o pagină.
cursorqueryCursorul din links.next. Nu există paginare cu offset.

Răspunsuri200 Listă de `DigitTicketMatchResource` Listă de `TicketMatchResource`404 422

POST/v1/lotteries/{lottery}/checkExtrageri · draws:read

Verifică până la douăzeci de bilete deodată în istoricul unui joc

Încearcă

Trimite tickets — fiecare {"numbers": [...], "bonus": [...]} — cu aceeași fereastră ca la o verificare individuală (range sau from/to) și primești rezumatul fiecărui bilet: cu câte extrageri s-a potrivit și cum. Extragerile propriu-zise sunt listate de verificarea unui singur bilet. Contează ca o singură cerere. Un joc cu un istoric foarte lung poate cere o fereastră mai scurtă pentru multe bilete deodată (ticket_check_too_large). Inclus în toate planurile și în perioada de probă.

ParametruLocDescriere
lotterypathCodul loteriei
ticketsqueryCâmp în corpul cererii: până la 20 de bilete, fiecare {"numbers": [...], "bonus": [...]}.

Răspunsuri200 404 422

Jackpoturi

GET/v1/lotteries/{lottery}/jackpotsCatalog · catalog:read

Cum a evoluat jackpotul anunțat al unui joc

Încearcă

Fiecare valoare distinctă pe care operatorul a anunțat-o pentru o extragere viitoare, cele mai noi primele, cu intervalul în care a fost văzută neschimbată. O valoare revizuită în cursul săptămânii devine o intrare nouă, așa că lista arată cum a crescut estimarea până la fiecare extragere. Istoricul începe de când am început să îl înregistrăm.

ParametruLocDescriere
lotterypathCodul loteriei
per_pagequeryDimensiunea paginii, cel mult 25. Poate doar să micșoreze o pagină.
cursorqueryCursorul din links.next. Nu există paginare cu offset.

Răspunsuri200 Set paginat de `JackpotSnapshotResource`404

Modificări și corecturi

GET/v1/draws/changesExtrageri · draws:read

Tot ce s-a întâmplat cu rezultatele, în ordine

Încearcă

Jurnalul de modificări prin care ții o copie a rezultatelor sincronizată fără să le recitești. Fiecare intrare spune ce s-a întâmplat — published, updated (sume completate ulterior: jackpotul, categoriile de premii), revised (numerele sau ora extragerii corectate) sau deleted —, ce câmpuri a atins și conține extragerea așa cum este acum; o extragere ștearsă conține doar ID-ul ei. Pornește de la filter[since], apoi urmează next_cursor de la o cerere la următoarea. Intrările mai vechi decât fereastra de păstrare nu mai sunt listate, cu excepția corecturilor; un client rămas mai în urmă de atât recitește lista de rezultate.

ParametruLocDescriere
filter[since]queryÎnceputul ferestrei de modificări, un moment ISO-8601. Apoi urmează cursorul.
filter[lottery]queryCoduri de loterie, separate prin virgulă.
per_pagequeryDimensiunea paginii, cel mult 100 (implicit).
cursorqueryCursorul din links.next. Nu există paginare cu offset.

Răspunsuri200 Set paginat de `DrawChangeResource`

GET/v1/draws/{draw}/revisionsExtrageri · draws:read

Corecturile unui rezultat, cele mai vechi primele

Încearcă

Fiecare intrare conține câmpurile corectate, cu valorile lor dinainte și de după. Un rezultat care nu a fost niciodată corectat nu are niciuna.

ParametruLocDescriere
drawpathID-ul extragerii

Răspunsuri200 Listă de `DrawRevisionResource`404

Calitatea datelor

GET/v1/lotteries/{lottery}/data-qualityCalitatea datelor · status:read

Cât de complete și cât de rapide au fost rezultatele unui joc

Încearcă

În ultimele 30 de zile: câte extrageri prevedea programul jocului, câte au fost publicate, câte nu le-a ținut operatorul și câte lipsesc — plus cât timp după ora programată a fiecărei extrageri a fost disponibil rezultatul, ca mediană, percentila 90 și cel mai lent caz. Se recalculează o dată pe zi. completeness este null pentru un joc extras după un calendar pe care niciun program fix nu îl descrie; data este null pentru un joc care nu a fost încă măsurat.

ParametruLocDescriere
lotterypathCodul loteriei

Răspunsuri200 `LotteryDataQualityResource`404

GET/v1/lotteries/{lottery}/freshnessCalitatea datelor · status:read

Cât de actuale sunt acum rezultatele unui joc

Încearcă

Dacă ultima extragere programată are rezultatul (current), este încă în intervalul în care sosesc de obicei rezultatele (awaiting) sau întârzie și este marcată ca lipsă (overdue); când s-au schimbat ultima dată aici rezultatele jocului, ceea ce nu e același lucru cu momentul ultimei extrageri; cât timp după ora programată a sosit ultimul rezultat, comparat cu întârzierea obișnuită; și câte rezultate au fost corectate recent după publicare. Se calculează la fiecare cerere, spre deosebire de cifrele zilnice de calitate a datelor.

ParametruLocDescriere
lotterypathCodul loteriei

Răspunsuri200 `LotteryFreshnessResource`404

Statistici

GET/v1/lotteries/{lottery}/generateStatistici · statistics:read

Generează bilete pentru un joc

Încearcă

Bilete valide și diferite între ele, fiecare la fel de probabil în limitele filtrelor, dacă weighting nu spune altfel. meta.space numără biletele permise de filtre — exact pentru filtrele numărate, estimat când e setat un filtru de formă. meta.seed repetă un rezultat. Niciun filtru nu schimbă șansa de câștig.

ParametruLocDescriere
lotterypathCodul loteriei
countqueryCâte bilete, de la 1 la 50. Implicit 5.
sizequeryNumere pe bilet, în limitele meta.sizes. Implicit câte sunt permise.
seedqueryRepetă un rezultat anterior: meta.seed întors atunci.
oddqueryExact atâtea numere impare pe bilet.
lowqueryExact atâtea numere din jumătatea de jos a bazinului (meta.low).
rangesqueryCâte numere exact din fiecare interval al bazinului: 1-10:2,11-20:1.
includequeryNumere pe care le are fiecare bilet, separate prin virgulă.
excludequeryNumere pe care nu le are niciun bilet, separate prin virgulă.
sum_minquerySuma minimă a unui bilet; sum_max e cea maximă.
max_consecutivequeryCel mai lung șir de vecini; la fel max_same_ending și max_per_decade.
never_drawnqueryDoar bilete pe care nu le-a avut nicio extragere.
avoid_popularqueryScoate combinațiile pe care le marchează mulți jucători.
numbers_fromqueryhot, cold sau overdue: alege doar din vârful acelui clasament pe window.
weightingqueryhot sau cold: favorizează numerele cele mai extrase sau cele mai puțin extrase. O preferință, nu o șansă mai bună.
windowqueryday … year sau all_time. Citește întâi meta.available_windows.

Răspunsuri200 404 422

GET/v1/lotteries/{lottery}/statisticsStatistici · statistics:read

Cele trei clasamente ale unui joc: cele mai extrase, cele mai puțin extrase și absente de cel mai mult timp

Încearcă

Analiză istorică a rezultatelor trecute, nu o predicție a celor viitoare.

ParametruLocDescriere
lotterypathCodul loteriei
combo_sizequeryNumere individuale, perechi sau triplete. Citește întâi meta.available_combo_sizes.
windowqueryday … year sau all_time. Citește întâi meta.available_windows.
limitqueryRânduri per clasament, cel mult 25.

Răspunsuri200 404

GET/v1/lotteries/{lottery}/statistics/distributionsStatistici · statistics:read

Cum s-au distribuit extragerile trecute ale unui joc, fiecare cifră lângă ce ar fi dat o extragere corectă

Încearcă

Analiză istorică a rezultatelor trecute, nu o predicție a celor viitoare.

ParametruLocDescriere
lotterypathCodul loteriei
windowqueryday … year sau all_time. Citește întâi meta.available_windows.

Răspunsuri200 404 422

Livrarea evenimentelor

GET/v1/streamFlux · stream:read

Rezultatele pe măsură ce sosesc, ca Server-Sent Events

Un rezultat nou ajunge într-un flux deschis la câteva secunde după publicare — cu mult în limitele a ceea ce înseamnă „live” pentru un joc care are extrageri cel mult la patru minute.

ParametruLocDescriere
filter[lottery]queryCodurile loteriilor urmărite. Fără filtru, fluxul conține loteriile la care are acces cheia ta.
cursorqueryPunctul de reluare. Last-Event-ID este respectat și are prioritate.

Răspunsuri200

GET/v1/webhooksWebhook-uri · webhooks:manage

Abonamentele pe care le are această cheie

Răspunsuri200 Listă de `WebhookEndpointResource`

POST/v1/webhooksWebhook-uri · webhooks:manage

Abonează-te. Secretul de semnare vine doar în acest răspuns — după aceea este criptat în stocare și poate fi înlocuit, dar nu citit

Răspunsuri201 `WebhookEndpointResource`422

GET/v1/webhooks/{webhookEndpoint}Webhook-uri · webhooks:manage

Afișează un abonament

ParametruLocDescriere
webhookEndpointpathID-ul endpoint-ului de webhook

Răspunsuri200 `WebhookEndpointResource`404

PATCH/v1/webhooks/{webhookEndpoint}Webhook-uri · webhooks:manage

Schimbă ce ascultă un abonament sau reactivează-l după ce a fost dezactivat pentru că nu putea fi contactat

ParametruLocDescriere
webhookEndpointpathID-ul endpoint-ului de webhook

Răspunsuri200 `WebhookEndpointResource`404 422

DELETE/v1/webhooks/{webhookEndpoint}Webhook-uri · webhooks:manage

Dezabonează-te definitiv, cu tot cu istoricul livrărilor

ParametruLocDescriere
webhookEndpointpathID-ul endpoint-ului de webhook

Răspunsuri200 404

POST/v1/webhooks/{webhookEndpoint}/rotate-secretWebhook-uri · webhooks:manage

Înlocuiește secretul de semnare și returnează-l pe cel nou o singură dată. Cel vechi nu mai verifică nimic imediat — regenerează-l când a ajuns pe mâini străine, nu după un program

ParametruLocDescriere
webhookEndpointpathID-ul endpoint-ului de webhook

Răspunsuri200 `WebhookEndpointResource`404

GET/v1/webhooks/{webhookEndpoint}/deliveriesWebhook-uri · webhooks:manage

Ce i s-a trimis acestui abonament, cele mai noi primele. Se poate filtra după filter[status]=dead — adică lista livrărilor eșuate definitiv, singurul lucru la care se uită majoritatea clienților

ParametruLocDescriere
webhookEndpointpathID-ul endpoint-ului de webhook

Răspunsuri200 Set paginat de `WebhookDeliveryResource`404

POST/v1/webhooks/{webhookEndpoint}/deliveries/{uuid}/replayWebhook-uri · webhooks:manage

Oferă din nou o livrare — calea de recuperare pentru un receptor care a fost indisponibil mai mult decât durează reîncercările

UUID-ul se păstrează, așa că un receptor care A PROCESAT originalul îl recunoaște drept același eveniment și îl poate ignora. Doar o livrare pe care coada a terminat-o — eșuată definitiv sau deja livrată — poate fi oferită din nou.

ParametruLocDescriere
webhookEndpointpathID-ul endpoint-ului de webhook
uuidpath

Răspunsuri202 404 422

POST/v1/webhooks/{webhookEndpoint}/testNu necesită permisiuni

Send the receiver a signed webhook.ping now and answer with what it did. Nothing is logged and the failure streak is untouched: a test is for whoever is looking at the result

ParametruLocDescriere
webhookEndpointpathID-ul endpoint-ului de webhook

Răspunsuri200 `WebhookTestResource`404

Exporturi în bloc

POST/v1/exportsExporturi · exports:read

Cere un export în bloc

Al unei loterii (lottery) la care are acces această cheie, ca csv sau ndjson, comprimat gzip. Se scrie tot istoricul inclus în plan, cu cea mai veche extragere întâi. Fișierul se pregătește în fundal: interoghează GET /v1/exports/{id} până când status e ready, apoi urmează download_url. Fiecare export se numără în plafonul lunar al contului (vezi meta din listă); unul eșuat nu se numără. Liniile NDJSON sunt obiectele de extragere de la GET /v1/draws/{id}, cu categoriile de premii; CSV-ul are aceleași câmpuri fără categorii, cu listele separate prin spații.

Răspunsuri200 422

GET/v1/exports/{export}Exporturi · exports:read

Arată un export, cu linkul de descărcare când e gata

ParametruLocDescriere
exportpathID-ul exportului

Răspunsuri200 `ExportResource`404

GET/v1/exportsExporturi · exports:read

Listează exporturile acestei chei

Ultimele 100, cele mai noi întâi. meta spune câte exporturi mai poate cere contul în luna UTC curentă, pe toate cheile lui.

Răspunsuri200 Listă de `ExportResource`

Cont

GET/v1/accountNu necesită permisiuni

Ce este cheia care face apelul: planul contului ei, permisiunile ei și ce a consumat contul azi. Testul de verificare rapidă al integrării — un client poate confirma că o cheie funcționează fără să aibă nevoie de vreo permisiune și își poate citi limita din răspuns

Încearcă

Răspunsuri200

LotteryWheel

GET/v1/lotteries/{lottery}/wheelStatistici · statistics:read

Construiește un sistem redus pe numerele tale

Încearcă

Bilete astfel încât, ori de câte ori if_drawn dintre numerele extragerii sunt printre ale tale, cel puțin un bilet are guarantee dintre ele — mult mai puține decât toate combinațiile (meta.full_system). Aceeași cerere întoarce mereu aceleași bilete. Un sistem schimbă biletele pe care le joci, nu șansa de câștig.

ParametruLocDescriere
lotterypathCodul loteriei
numbersqueryNumerele tale, separate prin virgulă: mai multe decât are un bilet, cel mult 40.
sizequeryNumere pe bilet, în limitele meta.sizes. Implicit câte sunt permise.
guaranteequeryCâte dintre numerele extrase are sigur un bilet.
if_drawnqueryCâte dintre numerele extragerii trebuie să fie printre ale tale ca garanția să se aplice. Implicit guarantee.
bonusqueryNumerele bonus de pe fiecare bilet, la jocurile care le joacă separat.

Răspunsuri200 404 422