Formaty i Listy

Konfiguracja Xtream Codes API: Dane Logowania, Port Serwera i Różnice z M3U

Poradnik logowania przez Xtream Codes API. Poznaj strukturę Server URL, portu, loginu i hasła. Rozwiązywanie błędów 401 i problemów z połączeniem.

Opublikowano: 2026-09-29

Weryfikacja techniczna 2026

Cel poradnika

Protokół Xtream Codes API to współczesny standard komunikacji pomiędzy odtwarzaczem multimedialnym a klastrem serwerów IPTV. W przeciwieństwie do tradycyjnych playlist M3U, autoryzacja przez API eliminuje konieczność ręcznego wklejania długich linków i automatycznie organizuje bibliotekę na Live TV, Filmy oraz Seriale.

Zakres techniczny: Techniczne omówienie struktury endpointów API Xtream, parametrów autoryzacyjnych i diagnostyki błędów HTTP 401/403/Timeout.

1 Wymagania wstępne przed konfiguracją

✓ Odtwarzacz ze wsparciem dla Xtream API (np. TiviMate, IPTV Smarters Pro, Televizo, XCIPTV)

✓ Komplet danych dostępowych: Server URL (z portem, jeśli jest wymagany), Nazwa użytkownika, Hasło

✓ Dostęp do internetu umożliwiający połączenie z adresem i portem serwera wskazanym przez dostawcę

2 Obsługiwane środowiska i kompatybilność

Urządzenie	System / Wersja	Region sklepu	Status	Uwagi
TiviMate IPTV Player	Android TV (Wszystkie wersje)	Global	Przetestowano	Optymalna metoda dodawania konta w TiviMate; automatycznie pobiera grupy i EPG.
IPTV Smarters Pro	Android / iOS / Windows / Mac (Wszystkie wersje)	Global	Przetestowano	Formularz 'Xtream Codes API' jest domyślnym i zalecanym sposobem logowania.
Aplikacje mobilne (Televizo, OTT Navigator)	Android (Wszystkie wersje)	Google Play Store	Przetestowano	Wymaga wprowadzenia pełnego protokołu (http:// lub https://).

3 Instrukcja konfiguracji krok po kroku

Zrozumienie struktury pól formularza Xtream

Dostęp Xtream Codes składa się z trzech fundamentalnych elementów: 1. Server URL (Host z ewentualnym portem) — np. http://twoj-serwer.com lub http://twoj-serwer.com:8080 (określa adres serwera i port wskazany przez operatora; przy standardowych portach 80 lub 443 dopisywanie portu zazwyczaj nie jest potrzebne). 2. Użytkownik (Username) — Twój indywidualny identyfikator konta. 3. Hasło (Password) — unikalny klucz autoryzacyjny sesji. Wszystkie trzy wartości otrzymasz od dostawcy przy aktywacji pakietu lub testu.

✓ Oczekiwany rezultat: Wiesz, jak przyporządkować otrzymane dane do pól w dowolnej aplikacji.

Wprowadź dane do odtwarzacza bez zbędnych spacji

Otwórz odtwarzacz i wybierz 'Dodaj konto Xtream Codes'. Wprowadź Server URL, login i hasło. Zwróć szczególną uwagę, aby na końcu adresu URL nie dopisywać ukośnika '/' (np. wpisz http://serwer.com:8080 a NIE http://serwer.com:8080/), ponieważ wiele aplikacji traktuje to jako błąd składni przy doklejaniu ścieżki /player_api.php.

✓ Oczekiwany rezultat: Formularz zostaje poprawnie zwalidowany przez aplikację.

Zatwierdź logowanie i odczekaj na pobranie tokenu

Kliknij przycisk 'Zaloguj' (Login / Add User). Aplikacja wysyła zapytanie GET /player_api.php do serwera, uwierzytelniając Twoje konto i pobierając token sesji oraz status ważności konta.

✓ Oczekiwany rezultat: Pojawia się komunikat o pomyślnym logowaniu, a interfejs prezentuje zorganizowane kategorie kanałów.

Sprawdź status konta i datę ważności

W menu ustawień konta (Account Info) możesz zweryfikować stan subskrypcji: datę wygaśnięcia konta (Expiration Date), liczbę dozwolonych jednoczesnych połączeń (Max Connections: 1) oraz status serwera.

✓ Oczekiwany rezultat: Informacje o Twoim pakiecie są czytelne i potwierdzają aktywny status dostępu.

Wsparcie techniczne 24/7

Gotowy do uruchomienia na swoim ekranie?

Wypróbuj logowanie przez Xtream Codes API na swoim ulubionym odtwarzaczu.

💬Poproś o dane Xtream Codes na test 24h→

Aktywacja testu w 5 minut • Bez zobowiązań

! Ważne ograniczenia i granice techniczne

• Jedno konto Xtream pozwala na oglądanie na 1 urządzeniu jednocześnie (chyba że posiadasz pakiet z wieloma połączeniami).
• Próba jednoczesnego odtwarzania na dwóch urządzeniach z jednego konta może skutkować przerwaniem strumienia.
• Odtwarzacze wymagają podania protokołu http:// lub https:// w zależności od konfiguracji serwera dostawcy.

4 Rozwiązywanie typowych problemów (Diagnostyka)

⚠️ Błąd 'HTTP 401 Unauthorized' lub 'Invalid Username/Password'

Co sprawdzić:

Sprawdź, czy login i hasło zostały przepisane z uwzględnieniem wielkości liter i bez spacji na końcu.

Prawidłowy stan:

Prawidłowe dane logują się bez błędów autoryzacji.

Zalecana akcja naprawcza:

Jeżeli dane są wpisane poprawnie, okres ważności konta mógł dobiec końca — skontaktuj się ze wsparciem w celu weryfikacji subskrypcji.

⚠️ Błąd 'Connection Failed' lub 'Timeout'

Co sprawdzić:

Sprawdź, czy wprowadzony adres Server URL jest prawidłowy, czy nie zawiera literówek, oraz czy sieć domowa nie blokuje niestandardowego portu komunikacyjnego.

Prawidłowy stan:

Aplikacja nawiązuje połączenie z serwerem w czasie poniżej kilku sekund.

Zalecana akcja naprawcza:

Zweryfikuj poprawność adresu z operatorem lub przetestuj połączenie przez alternatywną sieć (np. hotspot mobilny).

5 Najczęściej zadawane pytania (FAQ)

Dlaczego Xtream Codes jest lepsze od tradycyjnej listy M3U? ▾

Xtream Codes API przesyła uporządkowane dane w lekkim formacie JSON zamiast jednego wielkiego pliku tekstowego M3U. Dzięki temu aplikacja szybko pobiera dane, automatycznie rozdziela filmy VOD od kanałów na żywo i ułatwia konfigurację przewodnika EPG.

Czy z danych Xtream Codes mogę wygenerować link M3U? ▾

Tak. Tradycyjny link M3U można w prosty sposób zbudować z danych Xtream według wzoru: http://SERVER:PORT/get.php?username=LOGIN&password=HASLO&type=m3u_plus&output=ts.

Połączenie przez Xtream Codes to obecnie najwygodniejsza metoda korzystania z telewizji internetowej. Zapewnia natychmiastowe ładowanie bazy programowej i pełną kontrolę nad własnym kontem.

Porównanie formatów wyjściowych:

Format TS (.ts): Standardowy format strumieniowania na żywo z pełnym wsparciem dla wielokanałowego dźwięku AC3/E-AC3.
Format HLS (.m3u8): Zoptymalizowany pod kątem urządzeń firmy Apple (iPhone, iPad, Apple TV) oraz starszych telewizorów z wolniejszym łączem.

Polecane poradniki z Bazy Wiedzy

Ilustracja przedstawiająca składnię pliku M3U, parametry EXTINF oraz strukturę synchronizacji z przewodnikiem EPG XMLTV

Formaty i Listy

Lista M3U IPTV Polska: Struktura Playlisty, Synchronizacja EPG i Różnice z Xtream Codes

Praktyczny przewodnik po formatach M3U i M3U8 w Polsce. Dowiedz się, jak poprawnie wgrać listę kanałów, skonfigurować przewodnik EPG i dlaczego API Xtream Codes jest szybsze.

Otwórz poradnik →

Aplikacje i Oprogramowanie

Konfiguracja TiviMate: Playlista M3U, Logowanie Xtream Codes i Przewodnik EPG

Krok po kroku: jak skonfigurować TiviMate IPTV Player na Android TV i Firestick. Dodawanie playlisty Xtream Codes, synchronizacja EPG i optymalizacja bufora.

Otwórz poradnik →

Aplikacje i Oprogramowanie

Konfiguracja IPTV Smarters Pro: Logowanie Xtream Codes API i Ustawienia Odtwarzacza

Kompletny poradnik konfiguracji IPTV Smarters Pro na telewizor, telefon i PC. Logowanie przez Xtream Codes, wybór silnika VLC/ExoPlayer i napisy.

Otwórz poradnik →

Poradnik

Pomoc Techniczna IPTV & FAQ

Sprawdź szczegółowe informacje w sekcji Pomoc Techniczna IPTV & FAQ na PolskaTV IPTV.

Otwórz poradnik →

← Powrót do Bazy Wiedzy Strona główna