LOTTO OpenAPI (v1.0)

Pobierz specyfikację OpenAPI:Pobierz

Specyfikacja

Usługa LOTTO OpenAPI pozwala na pobranie powszechnie dostępnych danych przez usługę REST, są to m.in. wyniki, wygrane, statystyki, informacje o grach Totalizatora Sportowego, czy też różne statystyki.

Treści te są udostępniane bezpłatnie, a aby uzyskać dostęp do usługi LOTTO OpenAPI, wystarczy skontaktować się z nami przez adres email: [email protected], lub przez formularz kontaktowy: https://www.lotto.pl/kontakt. W treści prosimy o podanie: imienia, nazwiska, nazwy firmy (jeśli istnieje) oraz adresu email i numeru telefonu. Na tej podstawie utworzymy dostęp do LOTTO OpenAPI i wygenerujemy dla Ciebie klucz API key, który będzie służył do autoryzacji zapytań.

Autoryzacja

Usługa LOTTO OpenAPI udostępnia autoryzacje dostępu do metod za pomocą API key, który jest tokenem autoryzacyjnym.

Autoryzacja za pomocą klucza API (API Key) to metoda uwierzytelniania, w której użytkownik lub aplikacja klienta musi przesłać specjalny klucz w nagłówku żądania HTTP, aby uzyskać dostęp do zasobów serwera API. Klucz API jest unikalnym identyfikatorem, który serwer używa do weryfikacji tożsamości klienta i uprawnień do wykonania określonych operacji.

Przykład nagłówków:

accept: application/json
secret: GNq0pdsAAW2fPgXokLyZ4a8pJ1KEkKaj7kPICqQVbwg=

Przykład zapytania:

GET https://developers.lotto.pl/api/api/open/v1/departments?City=Kraków HTTP/1.1

ApiKey

API Key token autoryzacyjny. Przykład: "secret {key}"

Security Scheme Type: API Key
Header parameter name: secret

Changelog

Wersja 1.2 (10/30/2024)

  • Liczba wygranych - Szybkie 600
    • Poprawienie zaokrąglania wartości bonusu.
    • Poprawienie minimalnej kwoty bonusu.
  • Wprowadzenie sekcji Changelog do rozwiązania Open API.

Wersja 1.1 (09/03/2024)

  • Liczba wygranych - Szybkie 600
    • Dodanie wartości bonusu.
    • Poprawienie modelu wynikowego.
  • Dodanie wartości baseUrl do dokumentacji.

Wersja 1.0 (04/01/2024)

  • Udostępnienie rozwiązania OpenAPI.

Ogólne informacje

Informacje na temat gier.

Informacje na temat gry

Ogólne (opisowe) informacje na temat wybranej gry.

Authorizations:
ApiKey
query Parameters
gameType
string

Typ gry

Dostępne wartości:

  • Lotto
  • EuroJackpot
  • MultiMulti
  • MiniLotto
  • Kaskada
  • Keno
  • EkstraPensja
  • EkstraPremia
  • Szybkie600
  • ZakladySpecjalne

Responses

Response samples

Content type
application/json
{
  • "gameType": "string",
  • "nextDrawDate": "2019-08-24T14:15:22Z",
  • "closestPrizeValue": 0.1,
  • "draws": "string",
  • "couponPrice": "string",
  • "closestPrizePoolType": "string"
}

Wartość kumulacji

Wartość kumulacji dla gier kumulacyjnych – Lotto oraz Eurojackpot. Dla pozostałych zwraca najwyższą wartość możliwą do wygrania.

Authorizations:
ApiKey
query Parameters
gameType
string

Typ gry

Dostępne wartości:

  • Lotto
  • LottoPlus
  • EuroJackpot
  • MultiMulti
  • MiniLotto
  • Kaskada
  • Keno
  • EkstraPensja
  • EkstraPremia
  • Szybkie600
  • ZakladySpecjalne

Responses

Response samples

Content type
application/json
{
  • "jackpotValue": 0.1,
  • "jackpotPlusValue": 0.1,
  • "closestDraw": "2019-08-24T14:15:22Z"
}

Następne losowanie

Authorizations:
ApiKey
query Parameters
gameType
string

Typ gry

Dostępne wartości:

  • Lotto
  • LottoPlus
  • EuroJackpot
  • MultiMulti
  • MiniLotto
  • Kaskada
  • Keno
  • EkstraPensja
  • EkstraPremia
  • Szybkie600
  • ZakladySpecjalne

Responses

Response samples

Content type
application/json
{
  • "gameType": "string",
  • "closestPrizeValue": 0.1,
  • "nextDrawDate": "2019-08-24T14:15:22Z",
  • "playSitePath": "string"
}

Wyniki

Informacje na temat wyników.

Wyniki dla określonej daty

Ostatnie wyniki dla określonej daty. W zapytaniu należy podać zarówno datę jak i godzinę losowania.

Authorizations:
ApiKey
query Parameters
drawDate
string <date-time>

Data losowania

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Wyniki dla określonej daty oraz typu gry

Ostatnie wyniki dla określonej daty oraz typu gry. W zapytaniu należy podać zarówno datę losowania oraz typ gry. Dodatkowo można doprecyzować godzinę oraz minutę losowania.

Authorizations:
ApiKey
query Parameters
hour
integer <int32>

Godzina losowania

minute
integer <int32>

Minuta losowania

gameType
required
string

Typ gry

Dostępne wartości:

  • Lotto
  • LottoPlus
  • EuroJackpot
  • MultiMulti
  • MiniLotto
  • Kaskada
  • Keno
  • EkstraPensja
  • EkstraPremia
  • Szybkie600
  • ZakladySpecjalne
drawDate
required
string <date-time>

Data losowania

index
required
integer <int32>

Indeks.

Wartość 'index' > 0

size
required
integer <int32>

Rozmiar listy.

Wartość 'size' > 0

sort
required
string

Pole sortowania.

Dostępne wartości:

  • Wszystkie właściwości obiektu o określonym typie pola 'items'
order
required
string

Kolejność sortowania.

Dostępne wartości:

  • ASC - rosnąco
  • DESC - malejąco

Responses

Response samples

Content type
No sample

Ostatnie wyniki

Ostatnie wyniki losowań dla wszystkich gier liczbowych i loterii pieniężnych.

Authorizations:
ApiKey

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Ostatnie wyniki dla wybranej gry

Ostatnie wyniki losowań dla wybranej gry liczbowej lub loterii pieniężnej.

Authorizations:
ApiKey
query Parameters
gameType
string

Typ gry

Dostępne wartości:

  • Lotto
  • LottoPlus
  • EuroJackpot
  • MultiMulti
  • MiniLotto
  • Kaskada
  • Keno
  • EkstraPensja
  • EkstraPremia
  • Szybkie600
  • ZakladySpecjalne

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Wygrane

Informacje na temat wygranych.

Liczba wygranych

Liczba wygranych każdego stopnia dla wybranej gry liczbowej lub loterii pieniężnej z wyjątkiem Multi Multi, EuroJackpot, Szybkie600 oraz Keno. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:
ApiKey
path Parameters
drawType
required
string

Typ gry

Dostępne wartości:

  • Lotto
  • LottoPlus
  • MiniLotto
  • Kaskada
  • EkstraPensja
  • EkstraPremia
  • ZakladySpecjalne
drawSystemId
required
integer <int64>

Numer losowania

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Liczba wygranych – Eurojackpot

Liczba wygranych dla każdego stopnia gry liczbowej EuroJackpot. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:
ApiKey
path Parameters
drawSystemId
required
integer <int64>

Numer losowania

Responses

Response samples

Content type
application/json
{
  • "drawDate": "2019-08-24T14:15:22Z",
  • "drawSystemId": 0,
  • "gameType": "string",
  • "prizesEmpty": true,
  • "prizes": {
    },
  • "countriesPrizes": [
    ]
}

Liczba wygranych - Keno

Liczba wygranych dla każdego stopnia gry liczbowej Keno. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:
ApiKey
path Parameters
drawSystemId
required
integer <int64>

Numer losowania

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Liczba wygranych – Multi Multi

Liczba wygranych dla każdego stopnia gry liczbowej Multi Multi. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:
ApiKey
path Parameters
drawSystemId
required
integer <int64>

Numer losowania

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Liczba wygranych - Szybkie 600

Liczba wygranych dla każdego stopnia gry liczbowej Szybkie 600. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:
ApiKey
path Parameters
drawSystemId
required
integer <int64>

Numer losowania

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Największe wygrane

Informacje na temat największych wygranych.

Lista największych wygranych

Authorizations:
ApiKey
query Parameters
games
string

Gry.

Dostępne wartości:

  • Lotto
  • LottoPlus
  • MiniLotto
  • Kaskada
  • Keno
  • EkstraPensja
  • EkstraPremia
  • Szybkie600
  • ZakladySpecjalne

Wartości w zapytaniu można podawać po przecinku.

Przykład: games=Lotto,LottoPlus,MiniLotto

place
string

Miejsce.

onlyOnlineWins
boolean

Tylko wygrane online.

scratchId
integer <int64>

Identyfikator zdrapki.

index
required
integer <int32>

Indeks.

Wartość 'index' > 0

size
required
integer <int32>

Rozmiar listy.

Wartość 'size' > 0

sort
required
string

Pole sortowania.

Dostępne wartości:

  • Wszystkie właściwości obiektu o określonym typie pola 'items'
order
required
string

Kolejność sortowania.

Dostępne wartości:

  • ASC - rosnąco
  • DESC - malejąco

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "showMorePossible": true,
  • "totalRows": 0,
  • "items": [
    ],
  • "meta": null
}

Statystyki

Informacje na temat statystyk.

Częstość występowania liczb

Statystyki najczęściej występujących liczb w danej grze dla określonego przedziału czasowego.

Authorizations:
ApiKey
query Parameters
gameType
string

Typ gry

Dostępne wartości:

  • Lotto
  • LottoPlus
  • EuroJackpot
  • MultiMulti
  • MiniLotto
  • Kaskada
  • Keno
  • EkstraPensja
  • EkstraPremia
  • Szybkie600
  • ZakladySpecjalne
dateFrom
string <date-time>

Data od.

dateTo
string <date-time>

Data do.

Responses

Response samples

Content type
application/json
{
  • "totalDraws": 0,
  • "numberFrequrency": [
    ],
  • "numberSpecialFrequrency": [
    ]
}

Gierki

Informacje na temat gierek.

Lista Gierek

Lista Gierek wraz ze szczegółami.

Authorizations:
ApiKey
query Parameters
name
string

Nazwa

status
string

Status

Dostępne wartości:

  • Novelity - Nowość
  • Active - Aktywne
category
string

Kategoria

Dostępne wartości:

  • All - Wszystkie
  • Novelity - Nowość
  • HighestWins - Największe wygrane
  • HighestChance - Największa szansa
  • FavoriteGames - Ulubione gry
index
required
integer <int32>

Indeks.

Wartość 'index' > 0

size
required
integer <int32>

Rozmiar listy.

Wartość 'size' > 0

sort
required
string

Pole sortowania.

Dostępne wartości:

  • Wszystkie właściwości obiektu o określonym typie pola 'items'
order
required
string

Kolejność sortowania.

Dostępne wartości:

  • ASC - rosnąco
  • DESC - malejąco

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "showMorePossible": true,
  • "totalRows": 0,
  • "items": [
    ],
  • "meta": null
}

Szczegóły Gierki

Szczegóły dla danej gierki – stawki, wygrane, kwoty do wygrania.

Authorizations:
ApiKey
path Parameters
id
required
integer <int64>

Identyfikator Gierki

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "result": {
    },
  • "meta": null
}

Ekspres Losy

Informacje na temat ekspres losów.

Lista Ekspres losów

Lista Ekspres Losów wraz ze szczegółami.

Authorizations:
ApiKey
query Parameters
name
string

Nazwa.

status
string

Status

Dostępne wartości:

  • Standard - Standardowe
  • LastChance - Ostatnia szansa
  • Novelity - Nowość
  • Debut - Debiut
  • Announcement - Ogłoszenie
  • SalesEnd - Zakończenie sprzedaży
  • Archival - Archiwalne
yearSalesEnd
integer <int32>

Rok zakończenia sprzedaży.

index
required
integer <int32>

Indeks.

Wartość 'index' > 0

size
required
integer <int32>

Rozmiar listy.

Wartość 'size' > 0

sort
required
string

Pole sortowania.

Dostępne wartości:

  • Wszystkie właściwości obiektu o określonym typie pola 'items'
order
required
string

Kolejność sortowania.

Dostępne wartości:

  • ASC - rosnąco
  • DESC - malejąco

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "showMorePossible": true,
  • "totalRows": 0,
  • "items": [
    ],
  • "meta": null
}

Szczegóły Ekspres Losu

Szczegóły dla danego ekspres losu – stawki, wygrane, kwoty do wygrania.

Authorizations:
ApiKey
path Parameters
id
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "result": {
    },
  • "meta": null
}

Zdrapki

Informacje na temat zdrapek.

Lista Zdrapek

Lista Zdrapek wraz ze szczegółami.

Authorizations:
ApiKey
query Parameters
name
string

Nazwa

status
string

Status

Dostępne wartości:

  • Standard - Standardowe
  • LastChance - Ostatnia szansa
  • Novelity - Nowość
  • Debut - Debiut
  • Announcement - Ogłoszenie
  • SalesEnd - Zakończenie sprzedaży
  • Archival - Archiwalne
yearSalesEnd
integer <int32>

Rok zakończenia sprzedaży

index
required
integer <int32>

Indeks.

Wartość 'index' > 0

size
required
integer <int32>

Rozmiar listy.

Wartość 'size' > 0

sort
required
string

Pole sortowania.

Dostępne wartości:

  • Wszystkie właściwości obiektu o określonym typie pola 'items'
order
required
string

Kolejność sortowania.

Dostępne wartości:

  • ASC - rosnąco
  • DESC - malejąco

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "showMorePossible": true,
  • "totalRows": 0,
  • "items": [
    ],
  • "meta": null
}

Szczegóły Zdrapki

Szczegóły dla danej Zdrapki – stawki, wygrane, kwoty do wygrania.

Authorizations:
ApiKey
path Parameters
id
required
integer <int64>

Identyfikator Zdrapki

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "result": {
    },
  • "meta": null
}

Punkty LOTTO

Informacje na temat Odziałów Punktów LOTTO.

Lista wszystkich punktów LOTTO

Lista wszystkich punktów LOTTO, w których można zakupić kupon lub los.

Authorizations:
ApiKey
query Parameters
index
required
integer <int32>

Indeks.

Wartość 'index' > 0

size
required
integer <int32>

Rozmiar listy.

Wartość 'size' > 0

sort
required
string

Pole sortowania.

Dostępne wartości:

  • Wszystkie właściwości obiektu o określonym typie pola 'items'
order
required
string

Kolejność sortowania.

Dostępne wartości:

  • ASC - rosnąco
  • DESC - malejąco

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "showMorePossible": true,
  • "totalRows": 0,
  • "items": [
    ],
  • "meta": null
}

Oddziały Totalizatora Sportowego

Informacje na temat Oddziałów Totalizatora Sportowego.

Lista wszystkich Oddziałów Totalizatora Sportowego

W Oddziałach Totalizatora Sportowego, możesz odebrać wysokie wygrane i załatwić wszystkie sprawy formalne.

Authorizations:
ApiKey
query Parameters
Name
string
Przykłady:
  • Name=Warszawa - I Oddział - Przykład 1
  • Name=Kraków - II Oddział - Przykład 2

Nazwa odziału.

City
string
Przykłady:
  • City=Warszawa - Przykład 1
  • City=Kraków - Przykład 2

Miasto odziału.

Responses

Response samples

Content type
application/json
[
  • {
    }
]