Xtream Codes API to oparty na logowaniu sposób dostarczania IPTV: zamiast jednego linku do playlisty podajesz adres serwera, nazwę użytkownika i hasło, a aplikacja pobiera Twoje kanały, filmy, seriale i program telewizyjny jako uporządkowane, automatycznie aktualizowane listy. To najczęstsza alternatywa dla zwykłej playlisty M3U i właśnie to mają na myśli nowoczesne odtwarzacze IPTV, gdy piszą „Login with Xtream Codes”. Ten przewodnik wyjaśnia, jak to działa, czym różni się od M3U oraz adresów portalu i jak korzystać z tego bezpiecznie.
Czym jest Xtream Codes API
Xtream Codes API zaczynał jako oprogramowanie panelowe, którego dostawcy IPTV używali do zarządzania subskrypcjami. Jego API — sposób, w jaki aplikacje komunikują się z tym serwerem — stało się de facto standardem, więc dziś „Xtream Codes API” oznacza głównie metodę logowania, z której korzysta Twój odtwarzacz, nawet jeśli za kulisami dostawca używa innego oprogramowania.
Cechą charakterystyczną jest to, że uwierzytelniasz się za pomocą trzech informacji:
- Adres serwera (Server URL) — adres serwera dostawcy, np.
http://example.com:8080. - Nazwa użytkownika (Username) — nazwa Twojego konta.
- Hasło (Password) — klucz Twojego konta.
Na ich podstawie aplikacja pobiera całą resztę. Nigdy nie wklejasz gigantycznej listy kanałów; serwer przekazuje Twojemu odtwarzaczowi ustrukturyzowane dane na żądanie.
Jak to działa
Gdy się logujesz, Twój odtwarzacz IPTV wywołuje API serwera i otrzymuje usługę podzieloną na przejrzyste sekcje:
- Uwierzytelnianie. Aplikacja wysyła Twoją nazwę użytkownika i hasło na adres serwera i otrzymuje w odpowiedzi dane konta (status, datę wygaśnięcia, dozwoloną liczbę połączeń).
- Kategorie treści. Serwer zwraca telewizję na żywo, VOD (filmy) i seriale jako osobne, podzielone na kategorie listy — a nie jeden płaski plik.
- Strumienie na żądanie. Gdy otwierasz kanał, aplikacja żąda tylko tego jednego strumienia, więc wczytywanie jest szybkie.
- EPG. Program telewizyjny dostarczany jest przez to samo API, dzięki czemu EPG pokrywa się z Twoimi kanałami bez osobnego adresu URL.
Ponieważ listy znajdują się na serwerze, dostawca może dodawać lub usuwać kanały, a Twoja aplikacja odzwierciedli to przy kolejnym odświeżeniu — bez ponownego importowania.
Xtream API a M3U a portal URL
Te trzy pojęcia się nakładają i często są mylone. Oto jak wypadają w porównaniu:
| Playlista M3U | Xtream Codes API | Portal URL (styl MAG) | |
|---|---|---|---|
| Co podajesz | Jeden adres URL lub plik playlisty | Adres serwera + nazwa użytkownika + hasło | Portal URL (powiązany z adresem MAC urządzenia) |
| Struktura treści | Jedna płaska lista | Skategoryzowane: Live / VOD / Seriale | Układ portalu zdefiniowany przez dostawcę |
| EPG | Osobny adres URL EPG | Wbudowane w API | Wbudowane w portal |
| Aktualizacje | Ponowny import, by odświeżyć | Automatyczne | Automatyczne |
| Typowe urządzenia | Niemal każdy odtwarzacz | TiviMate, IPTV Smarters itp. | Boxy MAG / emulatory STB |
W skrócie: M3U jest najprostsze i najbardziej uniwersalne, Xtream Codes API jest najlepiej uporządkowane dla aplikacji, a portal URL to styl set-top-box powiązany z adresem MAC Twojego urządzenia. Wielu dostawców oferuje wszystkie trzy z tego samego konta.
Warto wiedzieć: większość serwerów Xtream potrafi też udostępnić link M3U po dodaniu ścieżki get.php — np. http://server:port/get.php?username=USER&password=PASS&type=m3u_plus — dzięki czemu odtwarzacz, który akceptuje tylko M3U, wciąż wczyta te same kanały.
Jak się zalogować
Logowanie przez Xtream Codes zajmuje w większości odtwarzaczy mniej niż minutę:
- Wybierz kompatybilny odtwarzacz, taki jak TiviMate lub IPTV Smarters — zobacz nasz przewodnik po najlepszych odtwarzaczach IPTV.
- Wybierz „Login with Xtream Codes” (czasem „Xtream Codes API” lub „Add Playlist → Xtream”).
- Wpisz swoje trzy pola — adres serwera, nazwę użytkownika, hasło — dokładnie tak, jak podał je Twój dostawca, łącznie z numerem portu.
- Poczekaj na wczytanie. Aplikacja automatycznie pobierze telewizję na żywo, VOD, seriale i EPG.
- Uporządkuj. Ukryj nieużywane kategorie i zmień kolejność ulubionych; większość odtwarzaczy zapamiętuje to dla każdego profilu.
Pełny opis konfiguracji aplikacji znajdziesz w naszym przewodniku po konfiguracji TiviMate.
Czy to legalne?
Protokół Xtream Codes API jest legalny — to metoda dostarczania treści, dokładnie jak M3U. Liczy się dostawca stojący za danymi logowania.
- Legalne: dane logowania od usługi, która ma prawa do kanałów, które streamuje.
- Nielegalne: tanie loginy „wszystkie kanały” sprzedawane bez żadnych praw, niezależnie od tego, jak dopracowana wygląda aplikacja.
Ostrzeżenie: efektowne logowanie Xtream nie czyni usługi legalną. Obowiązują te same sygnały ostrzegawcze co przy każdym IPTV — wszystkie kanały premium za kilka euro, płatność kartą podarunkową lub kryptowalutą oraz brak prawdziwej firmy. WatchlyGuide opisuje wyłącznie licencjonowane źródła.
Podsumowanie
Xtream Codes API to po prostu schludniejszy sposób logowania do IPTV: trzy pola — adres serwera, nazwa użytkownika i hasło — które wczytują Twoją telewizję na żywo, filmy, seriale i program jako uporządkowane, samoaktualizujące się sekcje. Jest bardziej ustrukturyzowane niż płaskie M3U i różni się od portalu URL w stylu MAG, choć wiele kont obsługuje wszystkie trzy. Użyj kompatybilnego odtwarzacza, wpisz swoje dane dokładnie i zawsze wyłącznie u dostawcy, który ma odpowiednie prawa.
Następnie porównaj to z formatem playlisty M3U albo zacznij od podstaw, sprawdzając, czym jest IPTV i jak właściwie działa streaming.
Nie masz pewności co do jakiegoś pojęcia na tej stronie? Sprawdź je w słowniku streamingu.