Den første forespørgsel: din konto
Hver session begynder med serveradressen, player_api.php og dit login:
http://example.com:8080/player_api.php?username=DITNAVN&password=DINKODE
Svaret beskriver din konto og serveren. Dokumenterede eksempler indeholder auth, status, exp_date (slutdatoen som et tidsstempel), is_trial, active_cons, max_connections og allowed_output_formats. Det er derfra, appen henter din slutdato og din forbindelsesgrænse. Se »account expired« og for mange forbindelser.
Listerne: én handling ad gangen
Hver del af appen er en separat forespørgsel, hvor &action= og et navn lægges til den samme adresse. Biblioteket py-xtream-codes med åben kildekode bygger disse forespørgsler:
| Handling | Returnerer |
|---|---|
get_live_categories | Grupperne til live-tv |
get_live_streams | Livekanaler (tilføj &category_id= for én gruppe) |
get_vod_categories | Filmkategorierne |
get_vod_streams | Film (valgfrit pr. kategori) |
get_vod_info | Detaljer om én film (&vod_id=) |
get_series_categories | Seriekategorierne |
get_series | Serier (valgfrit pr. kategori) |
get_series_info | Sæsoner og afsnit af én serie (&series_id=) |
get_short_epg | De næste guideposter for en kanal (&stream_id=, valgfrit &limit=) |
get_simple_data_table | Alle guideposter for en kanal |
Hele guiden for alle kanaler kommer fra en separat adresse, xmltv.php, med det samme brugernavn og den samme adgangskode. Bibliotekets noter tilføjer, at nogle servere accepterer parametrene offset og items_per_page til at bladre gennem lange lister.
Sådan bygges streamadresserne
API'et returnerer lister med stream-id, ikke færdige links; appen bygger hver adresse:
| Indhold | Adresseformat | Filendelsen kommer fra |
|---|---|---|
| Livekanal | /live/brugernavn/adgangskode/streamID.ext | allowed_output_formats (for eksempel ts eller m3u8) |
| Film | /movie/brugernavn/adgangskode/streamID.ext | Filmens target_container |
| Afsnit | /series/brugernavn/adgangskode/streamID.ext | Afsnittets target_container |
Derfor kan din app tilbyde forskellige streamformater: serveren oplister, hvilke formater din konto må bruge.
Hvad det forklarer i praksis
- Delene indlæses hver for sig. Live-tv, film og serier er forskellige forespørgsler, så én del kan være tom eller langsom, mens de andre virker. Se film og serier afspilles ikke.
- Guiden kan komme to steder fra. Nogle apps viser korte guidedata pr. kanal; andre indlæser hele filen fra
xmltv.php. En guide, der virker i én app, men ikke i en anden, skyldes ofte den forskel. Se XMLTV forklaret. - Et M3U-link er et øjebliksbillede. Mange servere kan også lave en M3U-playliste ud fra det samme login, med
get.php; den samler livelisten i én fil, uden API'ets separate dele. Se fra Xtream Codes til M3U.
Hold dit login hemmeligt
Hver eneste af adresserne indeholder dit brugernavn og din adgangskode i klar tekst. Indsæt dem ikke i fora, skærmbilleder eller supportchats med fremmede, og installer ikke apps, der beder dig dele dem med en tredjepartstjeneste, du ikke stoler på. Alle, der har linket, kan bruge din konto. Se dine Xtream Codes-loginoplysninger.