API i integracje etoto — dostęp, dokumentacja i zastosowania
Czym jest etoto API?
Etoto API (znane też jako „api etoto” lub interfejs programistyczny etoto) to zestaw usług sieciowych pozwalających na integrację z platformą bukmacherską etoto. Dzięki etoto api partnerzy, dostawcy danych i twórcy aplikacji mogą pobierać oferty, kursy, stany kont, realizować zakłady i obsługiwać zdarzenia na żywo.
API etoto najczęściej występuje jako REST/JSON z dodatkowymi mechanizmami webhooków (push) — to standardowy sposób na szybkie i automatyczne łączenie systemów z platformą bukmacherską.
Zastosowania integracji etoto obejmują m.in.: agregację kursów, automatyczne typowanie, integracje B2B, white-label, aplikacje mobilne oraz systemy back-office.
Dostęp i autoryzacja
Aby korzystać z etoto api, zazwyczaj wymagane są:
- konto firmowe lub partnera oraz weryfikacja tożsamości (Rejestracja i weryfikacja);
- podpisanie umowy partnerskiej lub zgłoszenie integracji przez dział techniczny;
- wygenerowanie klucza API / tokena OAuth (metoda zależy od zakresu dostępu).
W praktyce proces wygląda następująco: zgłaszasz się do działu technicznego lub partnerów, otrzymujesz środowisko testowe (sandbox) i klucz dostępu, a następnie przechodzisz przez procedury bezpieczeństwa i limitów. W przypadku pytań pomoc techniczna jest dostępna pod Kontakt / Pomoc lub przez stronę wsparcia technicznego (/etoto-wsparcie-techniczne).
Etoto dokumentacja i repozytorium (gitlab.etoto.pl)
Oficjalna etoto dokumentacja zwykle zawiera opis endpointów, schematy request/response, przykłady błędów oraz wytyczne do integracji. Część materiałów technicznych i kodu może być udostępniana w wewnętrznym repozytorium (np. gitlab.etoto.pl) dla zweryfikowanych partnerów.
Jeśli chcesz zacząć od dokumentacji, sprawdź:
Uwaga: dostęp do niektórych zasobów może być ograniczony i wymagać zgody lub podpisania NDA.
Najważniejsze endpointy i przykłady zastosowań
Poniżej przykładowa lista typowych endpointów (nazwy orientacyjne). Konkretne ścieżki i parametry znajdziesz w etoto dokumentacja.
| Endpoint (przykładowo) |
Metoda |
Opis |
| /events |
GET |
Pobierz listę wydarzeń sportowych (filtrowanie po dyscyplinie, czasie) |
| /markets |
GET |
Pobierz rynki dla wydarzenia (wynik, over/under, handicap) |
| /odds |
GET |
Aktualne kursy (możliwość subskrypcji) |
| /bets |
POST |
Złóż zakład / sprawdź kupon |
| /bets/{id} |
GET |
Status zakładu, historia |
| /cashout |
POST |
Wniosek o cashout (jeśli dostępny) |
| /balance |
GET |
Stan konta, historia transakcji |
| /webhooks |
POST |
Rejestracja webhooków do eventów (powiadomienia push) |
Przykładowe użycie (przykład curl):
curl -X GET "https://api.etoto.pl/v1/odds?eventId=12345" \
-H "Authorization: Bearer <TWÓJ_TOKEN>" \
-H "Accept: application/json"
Warto pamiętać o cache'owaniu danych kursowych (krótkie TTL), obsłudze błędów i ponownych prób w przypadku 5xx oraz reagowaniu na webhooki, które dostarczają informacje w czasie rzeczywistym.
Przykładowa integracja — krok po kroku
- Zgłoszenie i uzyskanie dostępu: skontaktuj się z działem partnerów lub wsparciem technicznym.
- Środowisko testowe: otrzymujesz sandbox i klucze.
- Implementacja core: implementujesz pobieranie wydarzeń, kursów i składanie zakładów.
- Webhooki i powiadomienia: konfigurujesz push, aby reagować na zmianę kursów i statusów.
- Testy E2E: sprawdzasz scenariusze wypłat, zwrotów, anuluje zakłady.
- Przejście na produkcję: po walidacji i akceptacji możesz przełączyć klucze na produkcję.
Integracje z aplikacją mobilną można dodatkowo synchronizować z aplikacją mobilną etoto oraz systemami płatności.
Bezpieczeństwo, limity i zgodność z regulacjami
Bezpieczeństwo integracji to priorytet:
- TLS/HTTPS obowiązkowo;
- autoryzacja tokenami (Bearer) lub podpisami HMAC;
- mechanizmy rate limiting — przestrzegaj limitów, aby uniknąć blokad;
- logowanie i audyt operacji (przydatne przy reklamacji).
Pamiętaj też o zgodności z regulacjami gamblingowymi i warunkami etoto — zapoznaj się z regulaminem oraz zasadami odpowiedzialnej gry (etoto-odpowiedzialny-hazard). Jeśli integracja wiąże się z transferami środków lub bankowością, sprawdź zasady dotyczące limitów i weryfikacji (etoto-limity-ograniczenia).
Monitorowanie, sandbox i testy
Dobre praktyki operacyjne:
- korzystaj najpierw ze środowiska sandbox;
- testuj scenariusze awaryjne (opóźnienia, utrata połączenia);
- monitoruj użycie API i opóźnienia (SLA);
- automatyczne alerty na błędy 4xx/5xx.
Jeżeli napotkasz problemy po wdrożeniu, zgłoś je do kontakt-pomoc-etoto lub działu technicznego.
Najczęściej zadawane pytania (FAQ)
- Czy dokumentacja jest publiczna? Część dokumentacji jest publiczna, a szczegóły techniczne i repozytoria (np. gitlab.etoto.pl) mogą być dostępne po autoryzacji.
- Jak uzyskać sandbox? Skontaktuj się z działem partnerów lub wsparciem.
- Czy mogę używać webhooków? Tak — webhooki to standard dla szybkich powiadomień o zmianach.
- Co z limitem zapytań? Limity są egzekwowane; planuj cache i backoff.
Zakończenie i CTA
Integracje z wykorzystaniem etoto api otwierają wiele możliwości — od automatycznego pobierania kursów po pełne systemy typerskie i rozwiązania B2B. Kluczem jest dostęp do dokumentacji (często dostępnej dla partnerów w gitlab.etoto.pl), solidna autoryzacja i testy w sandboxie.
Masz projekt integracyjny lub pytania techniczne? Skontaktuj się z działem wsparcia: Kontakt / Pomoc lub sprawdź stronę partnerów: Program partnerski. Jeśli dopiero zaczynasz, zacznij od rejestracji i weryfikacji i dokumentacji technicznej.
Powodzenia przy budowie integracji — jeśli potrzebujesz pomocy przy implementacji, testach lub audycie API, napisz do nas już dziś.