Hjälpcenter
Frågor och svar
Hur krediter, paket, linjer, uppspelningslänkar och enheter fungerar — och vad du ska kontrollera när något inte spelas upp.
140 av 140 frågor
Så använder du den här sidan
Varje fråga har en fast kod (till exempel LINE-07). Ange den när du kontaktar supporten, eller kopiera länken till frågan.
Namn på menyer, knappar och fält skrivs som panelen visar dem. En user (användare) är ett konto som loggar in i panelen (admin, återförsäljare); en linje är en tittares IPTV-prenumeration. De två blandas aldrig ihop.
- Tittare En återförsäljare kan vidarebefordra det här svaret till en tittare som det är
- Administratör För panelens operatör
Tjänstöversikt och vem som ansvarar för vad
GENGEN-01 Vad tillhandahåller den här tjänsten?
Ett komplett OTT- / IPTV-system: adminpanelen (dashboard), API-servern för tittarnas appar, leverans av livekanaler, filmer, serier och radio samt en webbspelare. Vi tillhandahåller och underhåller systemet; återförsäljare använder det för att ge sina kunder rätt att titta (linjer).
GEN-02 Vad gör tjänsten inte?
- Den tar inte emot pengar åt dig och har ingen betalningsgateway. Priset för dina kunder, hur du får betalt och fakturering är återförsäljarens sak (se CON-01).
- Den kontaktar inte en återförsäljares tittare. Panelen skickar bara e-post till panelkonton, aldrig till en linje.
- Den sparar inga personuppgifter om en raderad kund och har ingen återställningsfunktion (se DATA-01).
GEN-03 Vem är vem i systemet?
| Roll | Vem det är | Var de loggar in |
|---|---|---|
| Admin | panelens operatör | dashboard |
| Reseller | säljer linjer; får krediter av admin | dashboard, Reseller API |
| Underåterförsäljare | en återförsäljare skapad under en annan återförsäljare | dashboard, Reseller API |
| Linje | en prenumerant — slutkunden som tittar | IPTV-app, set-top-box, webbspelare. Aldrig dashboarden |
GEN-04 Vilka steg tar en kanal till tittaren?
- Admin bygger katalogen (kanaler, filmer, serier, radio) och grupperar den i bouquets.
- Admin skapar ett paket: bouquets + giltighetstid + antal anslutningar + pris i krediter.
- En återförsäljare använder krediter för att sälja paketet → systemet skapar en linje.
- Kunden anger linjens uppgifter i en app; systemet kontrollerar linjen (inte utgången, aktiverad, inom sina gränser) och spelar upp från en lämplig server.
GEN-05 Vad kan en återförsäljare göra med innehållet, och vad inte?
En återförsäljare kan visa listorna över kanaler, filmer, serier, radio, bouquets och paket (när gruppen har behörighet), men kan inte lägga till, redigera eller ta bort innehåll. Innehåll och paket hanteras av admin. En återförsäljare bestämmer vad varje kund får titta på genom att välja paket (och bouquets, när gruppen tillåter det — PKG-05).
GEN-06 Var får jag support?
Posten Support i sidomenyn öppnar den separata supportsidan. Panelen har inget eget ärendesystem. När du skickar en förfrågan, ange: linjens användarnamn (aldrig lösenordet), när det hände, appen / enheten och frågekoden från den här sidan om du redan har provat den.
GEN-07 Vilka språk finns i gränssnittet?
Panelen, webbspelaren och den här hjälpsidan har en språkväxlare med 27 språk. Engelska och vietnamesiska är referensöversättningarna; på de andra språken kan en nyligen tillagd skärm förbli på engelska ett tag. E-post som panelen skickar är för närvarande bara på engelska.
GEN-08 Var laddar jag ner panelen, och hur installerar eller uppgraderar jag den?
Administratör
Installationspaketen, deras SHA-256-kontrollsummor och den fullständiga installationsguiden (på engelska) finns på https://download.xtream-ui.pro.
- Du behöver: Ubuntu 22.04 eller 24.04 (virtuell maskin eller fysisk server), root eller sudo, helst en nyinstallerad server.
- Installera: ladda ner paketet för din CPU direkt på servern, kontrollera det med
sha256sum, packa upp det och körsudo ./install.sh. - Uppgradera en server som körs:
sudo ./upgrade.sh --tag <version>.
Domäner med TLS, edge-noder och alla alternativ förklaras i guiden.
Panelkonton och inloggning
ACCACC-01 Varför kan min kund inte logga in i dashboarden?
Det är avsiktligt: en linje är inte ett panelkonto. En kund använder bara linjens uppgifter i en IPTV-app, en set-top-box eller webbspelaren. Omvänt kan ett återförsäljarkonto inte användas för att titta på kanaler.
ACC-02 Jag ser färre menyer än vad den här sidan beskriver. Varför?
Menyer och åtgärder beror på vilken grupp admin gav ditt konto. En sida som din grupp saknar behörighet till visas inte i sidomenyn och kan inte öppnas. Be admin om fler behörigheter.
ACC-03 Var ändrar jag mitt panellösenord?
I kontoområdet (profil → ändra lösenord). Panellösenord lagras hashade; ingen kan läsa dem — inte ens admin. Om du glömmer det, be kontot ovanför dig (din överordnade återförsäljare eller admin) att sätta ett nytt.
ACC-04 Varför loggas jag ut när jag byter nätverk?
Panelen kan konfigureras att avsluta en session när dess IP-adress ändras, så att en stulen session inte kan återanvändas. Logga in igen. Detta är en admininställning.
ACC-05 Vad händer efter flera felaktiga inloggningsförsök?
Panelen begränsar misslyckade inloggningar (konfigureras av admin). Över gränsen måste du vänta innan du försöker igen.
ACC-06 Hur skiljer sig ett demokonto från ett riktigt?
Ett demokonto visar bara gränssnittet: det kan inte ändra sitt lösenord, redigera sin profil, skapa aktiveringskoder eller göra något som inte går att ångra.
ACC-07 Mitt konto är "disabled". Vad betyder det?
Kontot ovanför dig har stängt av det: du kan inte logga in i panelen och dina API-nycklar nekas. Redan sålda linjer tas inte bort. Kontakta kontot ovanför dig.
ACC-08 Var granskar jag vad jag och mina underåterförsäljare har gjort?
Logs → Reseller Logs (när gruppen får visa loggar): varje linje eller enhet som skapats, redigerats, förnyats, aktiverats / inaktiverats eller tagits bort, varje underåterförsäljare som skapats och varje kreditöverföring — med debiterade krediter. Du ser bara dina egna poster och posterna för kontona under dig; loggen kan inte raderas (endast admin). Kreditboken (CRD) är fortfarande platsen för att stämma av ett saldo.
Krediter
CRDCRD-01 Vad är en kredit?
Panelens förbetalda enhet. Varje försäljning (skapa en linje, förnya, skapa aktiveringskoder, skapa en underåterförsäljare) tar krediter enligt paketpriset eller gruppavgiften. En kredit är inte pengar och panelen omvandlar den inte: vad en kredit är värd avtalar du och kontot ovanför dig om.
CRD-02 Hur fyller jag på krediter?
Krediter flödar uppifrån och ned: admin ger krediter till en återförsäljare, en återförsäljare överför dem till en underåterförsäljare. Betalningen till kontot ovanför dig sker utanför panelen.
CRD-03 Vems krediter debiteras?
Alltid det konto som utför åtgärden, även när linjen tilldelas en underåterförsäljare längre ned.
CRD-04 Var ser jag min kredithistorik?
Sidan Credits: en rad per rörelse, med datum, belopp, saldo efteråt, orsak och vem som gjorde det. Detta är kreditboken — den auktoritativa källan för ditt saldo.
CRD-05 Vad händer om jag inte har tillräckligt med krediter?
Hela åtgärden nekas: ingen linje skapas och inget debiteras. Ett saldo blir aldrig negativt.
CRD-06 Om jag trycker på spara två gånger eller nätverket bryts, debiteras jag två gånger?
Nej. Varje försäljningsbegäran bär ett request-id (request_id); om samma id skickas igen returneras det tidigare resultatet. Att skapa linjen och debitera krediterna lyckas alltid tillsammans eller avbryts tillsammans.
CRD-07 Får jag tillbaka krediter när jag tar bort en linje?
CRD-08 Kan jag ta tillbaka krediter jag överfört till en underåterförsäljare?
Ja: i underåterförsäljarens redigeringsformulär anger du ett negativt tal i fältet för kreditöverföring. Inget saldo kan gå under 0.
CRD-09 Hur vet jag i förväg hur många linjer jag kan köpa?
Paketväljaren i linjens formulär visar ditt eget pris. Via API:et returnerar åtgärden pricing ditt saldo, priset för varje paket och hur många du har råd med.
Paket, bouquets och priser
PKGPKG-01 Vad är skillnaden mellan en bouquet och ett paket?
En bouquet är en lista med innehåll (kanaler, filmer, serier). Ett paket är produkten du säljer: en eller flera bouquets, en giltighetstid, ett antal anslutningar, utdataformat, spärrar och ett pris i krediter (ordinarie pris och testpris).
PKG-02 Varför ser jag inte ett visst paket?
Ett paket kan bara säljas av de grupper admin valt för det. Ett paket som inte är avsett för din grupp visas inte i väljaren och nekas när det skickas via API:et.
PKG-03 Mitt pris skiljer sig från paketpriset. Varför?
Admin kan ange ett eget pris per återförsäljare för varje paket (0 = gratis). Det egna priset gäller för att skapa en ordinarie linje, förnya och ordinarie aktiveringskoder; det gäller inte för testperioder.
PKG-04 När admin ändrar ett pakets bouquets, ändras redan sålda linjer också?
Nej. Bouquets kopieras in i linjen vid försäljningen; att redigera paketet efteråt påverkar inte redan sålda linjer. En linje får paketets nya bouquets vid nästa förnyelse / paketbyte. (När innehållet i en bouquet ändras ser varje linje med den bouqueten det direkt. Att ta bort en bouquet tar bort dess id från varje linje och paket. Att ändra den globala bouquet-ordningen ändrar bara ordningen som lagrats på sålda linjer om du kryssar i rutan "apply to sold linjer and packages"; en linjer uppsättning bouquets ändras inte.)
PKG-05 Kan jag sälja bara en del av ett paket?
Bara när din grupp har Allow Bouquet Selection aktiverat: du kryssar i en del av paketets bouquets; inget ikryssat = hela paketet; bouquets utanför paketet tas bort. Priset ändras inte.
PKG-06 Vilka egenskaper hos en linje bestäms av paketet?
Utgångsdatum (idag + paketets giltighetstid), antal anslutningar, utdataformat, restreamer, enhetsspärr, påtvingat land, påtvingad server, ISP-spärr, bouquets. Värden som en återförsäljare anger för dessa fält ignoreras, utom bouquets (PKG-05) och ISP-spärren när gruppen har Allow Line Restrictions aktiverat.
PKG-07 Vad är ett paket av typen "MAG only" / "Enigma only"?
Ett paket som bara kan säljas för den typen av set-top-box; det kan inte säljas för en vanlig linje eller för den andra enhetstypen. Omvänt måste ett paket tillåta enhetstypen innan det kan användas i formuläret Add MAG / Add Enigma.
Linjer: skapa, redigera, förnya, ta bort
LINELINE-01 Vad behöver jag för att skapa en linje?
Du måste välja ett paket som din grupp får sälja och ha tillräckligt med krediter. Användarnamn / lösenord: skriv ditt eget (när gruppen tillåter det) eller lämna dem tomma så genereras de. En admin får också lämna ett av dem (eller båda) tomma när en linje skapas: systemet genererar 10 tecken och visar dem direkt efter att du sparat; redigeringsformuläret kräver fortfarande ett användarnamn.
LINE-02 Varför kan jag inte välja användarnamn / lösenord själv?
Din grupp har Allow Username Change / Allow Password Change avstängt: en ny linje får genererade värden. När du får skriva egna anges minimilängden av gruppen (8 tecken som standard).
LINE-03 Var kan jag se en linjer lösenord igen?
I linjens redigeringsformulär och i dialogrutan Generate play link i listan Linjer. Lösenord till linjer sparas läsbara eftersom IPTV-appar och spellistlänkar behöver dem. Ett genererat lösenord visas direkt efter att du sparat.
LINE-04 En gammal linje visar inget lösenord och kunden kan inte logga in?
Vissa linjer som skapats av en tidigare version av panelen har bara ett hashat lösenord. En sådan linje kan inte logga in och panelen visar inget lösenord för den. Sätt ett nytt lösenord i linjens redigeringsformulär och skicka det till kunden.
LINE-05 Vad kan en återförsäljare redigera på en linje efter försäljningen?
Enable / disable, återförsäljaranteckningar, kontakt, kategorimall, ägare (inom ditt eget träd); användarnamn och lösenord när gruppen tillåter det; begränsningar (IP-adresser, user agents, ISP-spärr) när gruppen har Allow Line Restrictions aktiverat; ett nytt bouquet-urval inom paketet när gruppen tillåter det. Paketet, utgångsdatum, antal anslutningar, testflaggan, utdataformat, enhetsspärr och land kan inte redigeras direkt — de ändras bara genom en förnyelse / ett paketbyte.
LINE-06 Hur förnyar jag en linje?
Två sätt, en regel:
- knappen Renew (charged) i listan: använder linjens nuvarande paket;
- fältet Extend with package i redigeringsformuläret: välj vilket paket du får sälja (så byter du också paket).
När du redigerar en linje och väljer en förnyelse i samma sparning är båda en transaktion: om förnyelsen nekas (för få krediter, paketet kan inte säljas) sparas inte heller redigeringen och inga krediter debiteras. Rätta och spara igen.
LINE-07 Behålls återstående tid när jag förnyar?
- Linjen har inte gått ut och det nya paketet är kompatibelt med det gamla → tiden läggs till det nuvarande utgångsdatumet.
- Linjen har gått ut, eller de två paketen är inte kompatibla → räknas från idag; eventuell återstående tid behålls inte.
"Kompatibelt" kontrolleras bara när det nya paketet har alternativet för kompatibilitetskontroll aktiverat: båda paketen måste ha samma bouquets, utdataformat, antal anslutningar, restreamer-flagga och enhetsspärr. Med alternativet avstängt räknas de alltid som kompatibla. Nya paket har alternativet aktiverat som standard (admin kan stänga av det); befintliga paket behåller sin inställning. En MAG- / Enigma-linje kan bara förnyas med, eller bytas till, ett paket som tillåter den typen av box.
LINE-08 Hur debiteras ett paketbyte (uppgradering / nedgradering)?
Ett paketbyte = köp av en ordinarie period av det nya paketet: det nya paketets fulla pris debiteras (ditt eget pris om du har ett), utan kredit för den oanvända delen. Linjen får alla egenskaper hos det nya paketet.
LINE-09 Vad är skillnaden mellan att inaktivera och ta bort en linje?
Disable: kunden kan inte logga in eller titta, pågående sessioner stängs inom ungefär en minut; prenumerationsperioden fortsätter löpa; du kan aktivera den igen när som helst. Delete: permanent, ingen återställning, ingen återbetalning (DATA-01). För en kund som pausar: inaktivera — ta inte bort.
LINE-10 Vad betyder linjens statusar?
| Status | Betydelse | Vem kan häva den |
|---|---|---|
| Active | användbar | — |
| Disabled | avstängd av återförsäljaren / ägaren | återförsäljare |
| Banned | spärrad av admin | endast admin |
| Expired | efter utgångsdatumet | en förnyelse |
| Trial | en testlinje, användbar tills testperioden tar slut | blir ordinarie vid förnyelse |
LINE-11 Vad händer när en linje går ut?
Kunden nekas tills linjen förnyas (en linje som både har gått ut och är banned ser klippet "expired", eftersom utgång kontrolleras först); pågående sessioner stängs inom ungefär en minut. Linjen tas inte bort automatiskt: förnya den så fungerar den igen med samma användarnamn / lösenord.
LINE-12 Kan jag lämna över en linje till en underåterförsäljare?
Ja: välj ett konto under dig som ägare. Ägaren ser linjen i sin egen lista. Krediterna debiteras fortfarande den som trycker på spara.
LINE-13 Vems linjer ser jag?
Dina egna och de som tillhör varje konto under dig. En linje utanför ditt träd finns inte för dig (svaret är "not found").
LINE-14 Vad används fälten "Contact" och "Reseller notes" till?
För att du ska komma ihåg vem kunden är (e-post, telefonnummer, ordernummer). Prenumeranten ser dem aldrig. De raderas för alltid när linjen tas bort.
LINE-15 Kan jag se vad en linje tittar på, och varifrån?
När gruppen har behörighet: Logs → Line Activity visar visningshistoriken för varje linje, och Logs → Live Connections visar varje öppen anslutning för linjer i ditt träd (vilken linje, vilken kanal, från vilken adress) med en knapp för att stänga den. Live Connections öppnas bara när admin för din grupp har aktiverat alternativet att visa kunders anslutningshistorik (rutan client connection logs i gruppformuläret); du ser aldrig anslutningar för en linje utanför ditt träd.
LINE-16 Varför visar listan Linjer inte linjer som hör till aktiveringskoder?
LINE-17 Innehåller utgångsdatumet i linjens formulär en tid?
Administratör
Ja. Fältet Expires on i linjens formulär är ett datum och en tid i panelens tidszon, så en linje kan gå ut en viss timme. Att öppna formuläret och spara utan att röra fältet behåller utgångstiden till sekunden — att redigera en anteckning eller bouquets ger inte en testlinje på timbasis extra tid. Ett värde som inte kan läsas rapporteras vid själva fältet och blir aldrig "går aldrig ut". Sidan för massredigering tar fortfarande ett datum, tolkat som slutet av den dagen.
Test
TRITRI-01 När kan jag skapa en testlinje?
När alla dessa gäller: admin har inte stängt av testperioder för återförsäljare; paketet har en testperiod; din grupp har Allowed Trials > 0; dina krediter är ≥ gruppens Minimum Trial Credits; och antalet testlinjer du skapat inom räknefönstret inte har nått kvoten.
TRI-02 Över vilket fönster räknas testkvoten?
Som anges på gruppen: day = de senaste 24 timmarna, month = de senaste 30 dagarna. Exempel, en kvot på 5 / dag: högst 5 testlinjer under valfria 24 timmar. En äldre testperiod frigör sin plats när den lämnar fönstret.
TRI-03 Kostar en testperiod krediter?
Exakt paketets testpris (oftast 0). En återförsäljares eget pris gäller inte för testperioder.
TRI-04 Varför är testrutan låst?
TRI-05 Hur gör jag om en testlinje till en ordinarie linje?
Förnya linjen med ett paket: linjen får en ordinarie period och är inte längre en testlinje. Användarnamn och lösenord är desamma, kunden behöver inte ställa in något på nytt.
Uppspelningslänkar, appar och format
PLAYPLAY-01 Var får jag länken till min kund?
Lines → Generate play link: välj format; länken byggs med linjens användarnamn och lösenord. Via API:et returnerar get_line färdiga länkar: m3u, m3u_hls, xmltv, player_api, web_player.
PLAY-02 Vilka appar kan en kund använda?
Tittare
Alla appar som stöder Xtream Codes API (IPTV Smarters, TiviMate, XCIPTV, GSE…): ange serveradress + användarnamn + lösenord. För en app som bara tar en spellista, använd länken M3U. MAG-boxar använder portalen, Enigma2-boxar använder en spellista / plugin. Utan någon enhet, använd webbspelaren i en webbläsare.
PLAY-03 MPEG-TS eller HLS?
MPEG-TS: snabb kanalväxling, passar IPTV-appar och set-top-boxar. HLS: fungerar bra i webbläsare, på Apple-enheter och på instabila nätverk. En linje kan bara använda de format som dess paket tillåter; en länk i ett format som inte är tillåtet nekas.
PLAY-04 Vilka spellisttyper finns?
m3u_plus (med logotyper, grupper, EPG-id — den rekommenderade standarden), vanlig m3u, typerna för Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive samt enkla listtyper. Välj en i dialogrutan Generate play link.
PLAY-05 Varifrån kommer programguiden (EPG)?
Tittare
Xtream-appar hämtar den själva. För en M3U-app, använd linjens XMLTV-länk (en m3u_plus-spellista innehåller redan EPG-adressen).
PLAY-06 Finns det catch-up?
Tittare
Ja, på de kanaler där admin har aktiverat arkivering; appar visar en catch-up-ikon på dessa kanaler.
PLAY-07 Var finns webbspelaren och hur loggar jag in?
Tittare
På /player/ på API-servern (länken web_player). Logga in med linjens användarnamn / lösenord, eller med en aktiveringskod.
PLAY-08 Fungerar en gammal länk fortfarande när jag ändrar linjens lösenord?
Nej. Lösenordet är en del av länken och lagras i appen; efter ett lösenordsbyte måste kunden ange det igen / få en ny länk. Så stänger du också ute någon som använder en linje utan tillstånd.
PLAY-09 Kan jag använda min egen domän för uppspelningslänkar?
Ja: ange Your own play address på sidan för API-nycklar (eller med API-åtgärden set_play_base). Du pekar domänens DNS till panelens API-server, och operatören måste konfigurera sin sida; berätta för admin innan du använder det. Adressen gäller för de länkar som API:et returnerar till ditt system.
MAG / Enigma2 set-top-boxar
DEVDEV-01 Hur lägger jag till en MAG- / Enigma-box?
Devices → Add MAG / Add Enigma: ange MAC-adressen, välj ett paket. Systemet säljer en ny linje och kopplar enheten i ett steg; enheten loggar in med sin MAC, ingen behöver skriva något användarnamn / lösenord. Krediter debiteras precis som för en vanlig linje.
DEV-02 Kunden har redan en linje och vill lägga till en box?
I enhetsformuläret väljer du kundens befintliga linje i stället för ett paket: enheten paras ihop med den linjen, utan kostnad. Kunden fortsätter använda linjen i appen; boxen följer linjens paket, utgångsdatum, bouquets och status.
DEV-03 Hur räknas anslutningar för en ihopparad app och box?
De delar anslutningsgränsen: appen och boxen är en prenumerant.
DEV-04 Hur förnyar jag en box?
Förnya dess linje (länken finns i enhetsformuläret). För en ihopparad enhet, förnya kundens linje — boxen följer av sig själv.
DEV-05 Kunden byter ut boxen mot en ny?
Redigera MAC-adressen på enheten. Om linjen har enhetsspärr aktiverad, rensa det registrerade serienumret / enhets-id:t så att den nya boxen kan registrera sig.
DEV-06 Tas linjen bort när jag tar bort en enhet?
Ja. Att ta bort en enhet tar också bort dess linje (med anslutningshistorik och väntande händelser). För att behålla en linje som är betald, använd knappen Convert to line: enheten tas bort och linjen blir en vanlig linje. När du tar bort en kunds linje lever en ihopparad enhet vidare självständigt med en egen linje.
DEV-07 Kan en återförsäljare styra en box på distans?
Sina egna MAG-boxar, ja: skicka ett meddelande till TV:n, spela en kanal, ladda om portalen, starta om, stänga linjens anslutningar (gruppen behöver behörighet att visa kunders anslutningsloggar), nollställa den registrerade ISP:n och nollställa STB-spärren. X-Plugin-kommandon och skärmdumpar från Enigma-boxar, att banna en enhet och att flytta en enhet till en annan linje är bara för admin. Att aktivera / inaktivera en återförsäljares enhet aktiverar / inaktiverar dess linje; en återförsäljare kan inte häva Banned på en enhet.
Aktiveringskoder
CODECODE-01 Vad används en aktiveringskod till?
Att sälja åtkomst som en kod (ett skraplott, en kod skickad i ett meddelande): kunden anger koden i en app eller i webbspelaren och kan titta, utan användarnamn / lösenord. Perioden börjar först när kunden aktiverar koden för första gången.
CODE-02 Hur skapar jag koder och vad kostar de?
Active Codes → New: välj paket, antal (1–500 per batch), kodlängd (6–24), alternativet endast siffror (lätt att skriva med en TV-fjärrkontroll) och testalternativet. Krediter debiteras vid skapandet = paketpris × antal koder. Varje kod får en egen linje, låst fram till aktivering.
CODE-03 Vilka tecken innehåller en kod?
Versaler och siffror utan de lätt förväxlade (0, O, 1, I); eller bara siffror. En kund som skriver med gemener accepteras ändå.
CODE-04 På hur många enheter kan en kod användas?
Tittare
En. Koden knyts till den första enheten som aktiverar den; en annan enhet som anger samma kod nekas. Den enheten får ange koden så många gånger den vill, linjens inloggningsuppgifter ändras inte.
CODE-05 Vad händer om kunden byter enhet?
Reset device på den koden; den nya enheten kan sedan aktivera den. Ingen tid läggs till perioden.
CODE-06 Kunden får ett fel när koden anges. Vad betyder det?
Tittare
| Meddelande | Betydelse | Vad du ska göra |
|---|---|---|
INVALID_CODE | fel kod / koden finns inte | kontrollera varje tecken; skriv inte bindestrecken |
DEVICE_MISMATCH | koden är knuten till en annan enhet | återförsäljaren nollställer enheten (CODE-05) |
DISABLED | koden är avstängd | återförsäljaren aktiverar den igen |
EXPIRED | perioden är slut | köp en kod / förläng |
Att ange flera olika felaktiga koder i rad gör att IP-adressen blockeras en stund (SEC-08).
CODE-07 Hur förlänger jag en kod som har aktiverats?
På sidan Active Codes kryssar du i koden, väljer åtgärden Extend (days) och anger antalet dagar. Bara en aktiverad kod får dagar tillagda (en oanvänd kod har inte påbörjat sin period); en kod som fortfarande är giltig förlängs från sitt nuvarande utgångsdatum, en utgången från nu. Den här åtgärden debiterar inga krediter, så bara en administratör får använda den: en återförsäljare förnyar kodens linje som vilken linje som helst, med ett paket och dess pris (Lines → Renew, eller renew_line i Reseller API). En felaktig debitering rättas till av supporten med en kreditjustering, aldrig med en gratis förlängning. Admin API: extend_active_code.
CODE-08 Får jag tillbaka krediter när jag tar bort en kod?
En oanvänd kod som skapats av återförsäljaren: full återbetalning, med en rad i kreditboken. En aktiverad kod: ingen återbetalning.
CODE-09 Hur hanterar jag många koder på en gång?
Sidan Batches visar totalt / redo / aktiverade / inaktiverade för varje batch och exporterar en TXT-fil (en kod per rad). Massåtgärder: enable, disable, reset device, delete.
CODE-10 Följer en aktiveringskods linje paketets gränser?
Anslutningsgränser och spärrar som skyddar en linje
SECSEC-01 Hur räknas "Max connections"?
Det är antalet enheter som tittar samtidigt med en linje. 0 = obegränsat. Att öppna kanalen du redan tittar på igen från samma enhet räknas inte som en ny anslutning.
SEC-02 Vem kopplas ner när gränsen överskrids?
Tittare
Som standard: den nya anslutningen släpps in och den äldsta stängs (en anslutning från samma enhet prioriteras, därefter från samma IP). Den stängda spelaren stannar inom ungefär 30 sekunder. Admin kan i stället välja att neka den nya anslutningen i stället för att stänga en gammal.
SEC-03 Vad är regeln om "andra IP-adressen"?
När admin har den aktiverad: medan en linje tittas på från en IP nekas en liveanslutning från en annan IP. Regeln kan begränsas till linjer med få anslutningar (till exempel linjer med 1 anslutning; en linje med obegränsade anslutningar binds bara när tröskeln är 0). Med Match The Address By Network aktiverat räknas adresser i samma /24-nätverk (IPv6: /64) som en tittare. Detta är ett verktyg mot kontodelning.
SEC-04 Kan jag begränsa en linje till vissa IP-adresser eller appar?
När gruppen har Allow Line Restrictions aktiverat: fältet Allowed IPs (en IP, ett CIDR-intervall eller ett domännamn, ett per rad; en domän slås upp vid anslutningen, så en dynamisk IP fungerar ändå) och Allowed User-Agents. Tomt = allt tillåtet. Obs: dessa begränsningar blockerar vid uppspelning; appen loggar fortfarande in och visar kanallistan.
SEC-05 Vad är ISP-spärren?
Linjen minns internetleverantören för sin första anslutning och nekar användning från en annan leverantör. När kunden byter leverantör, stäng av och slå på ISP-spärren igen för att registrera den nya. Den gäller inte för MAG-boxar.
SEC-06 Vad är enhetsspärren?
Den knyter linjen till den första set-top-box som loggar in (serienummer, enhets-id); en annan box nekas. Bestäms av paketet.
SEC-07 Hur fungerar landsbegränsningen?
En linje kan bara ansluta från sitt påtvingade land (ALL = var som helst). När det är tomt gäller panelens allmänna lista över tillåtna länder. En kund som reser utomlands eller använder VPN kan nekas av den anledningen.
SEC-08 Varför är en IP-adress blockerad?
Tittare
- Automatiskt: misslyckade inloggningar från en IP med många olika användarnamn / aktiveringskoder på kort tid, eller en flod av förfrågningar. Ett automatiskt block upphör av sig självt efter den tid admin konfigurerat (60 minuter som standard).
- Manuellt: admin blockerade IP-adressen / IP-intervallet; detta går inte ut.
Medan en IP är blockerad kan ingen linje ansluta från den. Att upprepade gånger skriva fel på samma användarnamn orsakar inget block.
SEC-09 Av vilka andra skäl kan en anslutning blockeras?
Admin kan blockera efter User-Agent (app), efter internetleverantör (ISP) och efter ASN (till exempel hosting- / VPN-intervall). En linje för vilken admin aktiverat "bypass UA" hoppar över appens blocklista.
SEC-10 Vad är en restreamer?
En linje för en partner som hämtar strömmarna för att distribuera dem vidare. Den är undantagen från anslutningsgränsen, regeln om andra IP-adressen, det automatiska avslutet av långa sessioner och ASN-blockering. Bestäms av paketet / admin; inte avsedd för vanliga tittare.
SEC-11 Avbryts en mycket lång sammanhängande session?
Tittare
Admin kan ange en maxlängd för en sammanhängande session; efter den stängs sessionen och kunden trycker på play för att fortsätta. En session som förlorar signalen i ungefär 90 sekunder räknas också som stängd.
SEC-12 Hur upptäcker jag en linje som delas eller är stulen?
- Sidan Theft Detection (när gruppen har behörighet): rangordnar linjer efter antalet olika filmer / avsnitt som setts på 1 timme / 24 timmar / 7 dagar, med antalet olika IP-adresser — en ovanligt hög linje är misstänkt.
- Linjens aktivitetssida: visar IP-adresserna och enheterna som används.
- Vad du ska göra: byt linjens lösenord (PLAY-08), aktivera IP-begränsningen / ISP-spärren, eller inaktivera linjen.
Underåterförsäljare
SUBSUB-01 Kan jag skapa underåterförsäljare?
När din grupp har Can Create Sub-Resellers aktiverat och minst en grupp i Groups for sub-resellers. Varje skapande debiterar den skapandeavgift (krediter) som anges på gruppen. Ett återförsäljarträd är högst 5 nivåer djupt.
SUB-02 Vilken grupp tillhör en underåterförsäljare, och vad får den göra?
Du väljer en grupp från den lista admin tillåter; gruppen bestämmer underåterförsäljarens behörigheter, säljbara paket och testkvot.
SUB-03 Vad kan jag hantera hos en underåterförsäljare?
E-post, namn, lösenord, status, grupp (från listan), anteckningar, överföring / återtagning av krediter och alla linjer under dem. Du kan inte ändra deras roll eller ägare.
SUB-04 Vad ser en underåterförsäljare av mitt?
Ingenting: varje konto ser bara det som finns under det, aldrig nivåerna ovanför eller andra grenar.
SUB-05 Vart går en underåterförsäljares linjer och krediter när jag tar bort den?
Gruppen behöver Can Delete Users aktiverat. De återstående krediterna, linjer och underkonton flyttas till kontot som tar bort. Kundernas linjer fortsätter fungera. Det raderade kontots personuppgifter (användarnamn, e-post, namn, lösenord, API-nycklar, anteckningar) raderas; det användarnamnet och den e-posten kan användas igen.
SUB-06 Får en ny underåterförsäljare ett e-postmeddelande?
När admin har aktiverat välkomstmeddelandet: det nya kontot får sitt inloggningsnamn och en inloggningslänk. E-postmeddelandet innehåller aldrig lösenordet — du skickar lösenordet själv.
Kategorimallar
CATCAT-01 Vad används en kategorimall till?
För att ändra ordning på, byta namn på eller dölja de kategorier (live, filmer, serier, radio) som en kund ser i appen — per linje, utan att röra panelens egna kategorier.
CAT-02 Vad händer när jag döljer en kategori?
Allt innehåll i den kategorin döljs också från appen och spellistan för de linjer som använder mallen.
CAT-03 När jag redigerar en mall, ändras linjer som använder den?
Ja, direkt för varje linje som mallen är tilldelad. När en mall tas bort återgår dess linjer till standardlayouten.
CAT-04 Vilka mallar kan jag se och redigera?
Se: dina egna och de som tillhör konton under dig, systemmallar och mallar delade av nivåerna ovanför. Redigera: bara dina egna och de under dig. För att justera en systemmall, duplicera den och redigera kopian.
CAT-05 Begränsningar värda att känna till?
Den anpassade kategoriordningen gäller inte film- / seriedelen av en M3U-spellista (namn och döljande gäller fortfarande). Appar som använder Xtream API får allt.
Reseller API, API-nycklar, webhooks
APIAPI-01 Vad används Reseller API till?
För ditt eget system (webbutik, fakturering, bot) för att sälja och hantera linjer / underåterförsäljare utan att öppna dashboarden. Adress: {API}/reseller/v1, autentiserad med rubriken X-API-Key. Fullständig dokumentation finns på /docs/ på API-servern.
API-02 Var får jag en API-nyckel?
Sidan API Key. En nyckel visas en gång, när den skapas — kopiera den direkt. Om du tappar bort den, skapa en ny nyckel (den gamla slutar fungera).
API-03 Ska jag använda en nyckel för alla system?
Helst inte. Skapa en extra nyckel per system: ge den ett namn, begränsa de IP-adresser / CIDR-intervall som får använda den, gör den eventuellt skrivskyddad (bara lista och visa) och återkalla den separat utan att påverka de andra nycklarna.
API-04 Vad kan API:et göra?
| Behov | Åtgärd |
|---|---|
| Saldo, priser, hur många du har råd med, regler för användarnamn / test | user_info, pricing, packages |
| Linjer | get_lines, get_line, create_line, renew_line, change_package, edit_line, enable_line, disable_line, delete_line |
| Underåterförsäljare | get_users, get_user, create_user, edit_user, adjust_credits, enable_user, disable_user, delete_user |
| Aktiveringskoder | skapa, lista, enable / disable, reset device, delete |
| Webhooks, egen uppspelningsadress, API-anropslogg | create_webhook…, set_play_base, api_logs |
Varje regel i dashboarden (grupp, eget pris, testkvot, trädomfång) gäller via API:et på exakt samma sätt.
API-05 Om jag försöker igen efter ett nätverksfel, debiteras jag två gånger?
Nej, så länge du skickar samma request_id för samma transaktion: systemet returnerar det tidigare resultatet. request_id för en förnyelse är bundet till den linjen: att återanvända det för en annan linje ger ett konfliktfel (HTTP 409) och den andra linjen ändras inte — generera ett nytt request_id för varje transaktion.
API-06 Min integration fungerar inte. Hur kontrollerar jag det själv?
Sidan API Key har en tabell med senaste API-anrop (30 dagar): åtgärd, resultat, felkod, anropande adress, connectorns namn. Parametrar registreras aldrig.
API-07 Vad är en webhook, och vilka händelser finns?
Panelen talar om för ditt system när något händer, så att du slipper fråga hela tiden. Händelser: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring (3 dagar i förväg), line.expired, credits.low (under tröskeln du anger). Mottagaradressen måste vara https och nåbar från internet.
API-08 Hur vet jag att en webhook är äkta?
Varje avisering bär signaturen X-Xtream-Signature: sha256=HMAC(secret, timestamp.body); hemligheten visas en gång, när slutpunkten skapas. En webhook innehåller aldrig något lösenord.
API-09 Webhooken har slutat skicka?
Varje avisering försöks 3 gånger; en slutpunkt som misslyckas med 20 leveranser i rad stängs av. Rätta till din sida, använd Send test och skapa sedan slutpunkten igen om den stängdes av.
API-10 Returnerar API:et lösenord till linjer?
Ja, men bara till linjens ägare (du och nivåerna ovanför dig i trädet). Spara inte lösenord till linjer i loggar och skicka dem inte över en osäker kanal.
API-11 Kan `edit_line` förnya en linje?
Ja, när du skickar med package_id (det gamla namnet package accepteras också): vid sidan av redigeringen säljer åtgärden en ordinarie period av det paketet precis som change_package — samma pris, samma request_id, och svaret innehåller credits_charged. Redigering och förnyelse är en transaktion: när den nekas (för få krediter, ogiltigt paket, trial skickat med) ändras ingenting. edit_line utan paket redigerar bara användarnamn, lösenord, kontakt och anteckningar och rör inte paketet eller utgångsdatumet.
API-12 Fungerar ett skript skrivet för en annan panel med det här API:et?
Inte som det är. API:et behåller de välbekanta åtgärdsnamnen men är ett nytt gränssnitt: adressen /reseller/v1, en API-nyckel skapad i den här panelen, skrivåtgärder skickade med POST, fel returnerade som en HTTP-status med ett error-fält, och resultatet av att skapa en linje i data.line. Använd dokumentationen på /docs/ eller en färdig connector (CON-02).
Connectors för butiks- och faktureringssystem
CONCON-01 Hur tar jag emot pengar från mina kunder?
Med ditt eget system och din egen betalningsgateway. Panelen hanterar inte betalningar. En connector kopplar ditt butikssystem till panelen: kunden betalar hos dig → connectorn anropar Reseller API för att skapa / förnya linjen.
CON-02 För vilka plattformar finns det en connector?
WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, och en "webhook bridge" för Shopify, Upmind och Invoice Ninja.
CON-03 Var laddar jag ner och installerar en?
I panelen: sidomenyn Resources → All Connectors — varje connector med anslutningsuppgifter, installationssteg, en knapp Download och filens SHA-256 för att verifiera den.
Samma connectors, med installationssteg och kontrollsummor, publiceras på https://plugins.xtream-ui.pro; källkoden finns på https://github.com/xtreamui-pro/plugins.
CON-04 Hur väl har connectorerna testats?
Det skiljer sig per connector, och varje connectors sida anger det: vissa har körts i den riktiga plattformen (till exempel WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), andra har bara fått sin kärna testad. Läs raden "how it was tested" och prova i en testmiljö innan du säljer på riktigt.
CON-05 Är en connector säker, och vad gör den med panelen?
CON-06 Vad kan en connector sälja?
Linjer (skapa, förnya, byta paket, pausa, ta bort) och underåterförsäljarkonton med krediter.
Data, radering och integritet
DATADATA-01 Kan en borttagen linje återställas?
Nej. Borttaget är borta: linjens uppgifter (användarnamn, lösenord, kontakt, anteckningar), dess anslutningshistorik (IP-adresser, enheter, vad som setts), set-top-boxarna kopplade till linjen och dess aktiveringskod. Det finns ingen papperskorg och ingen återställningsfunktion eller något API för det. När kunden kommer tillbaka, skapa en ny linje.
DATA-02 Vad behåller systemet efter en borttagning?
Bara en anonym statistisk post för operatören (ny eller återkommande kund, vilka paket som är populära). Den innehåller inget läsbart om kunden och ingen återförsäljare, connector eller API kommer åt den.
DATA-03 Kan en backup få tillbaka en borttagen linje?
Nej. Databasbackuper finns bara för att återuppbygga systemet efter en incident och hålls av operatören; de används inte för att ångra en borttagning. Gamla backuper roteras bort, så borttagna data försvinner även därifrån.
DATA-04 Varför är ett lösenord till en linje läsbart men ett panellösenord inte?
Ett lösenord till en linje måste skrivas in i appar och är en del av spellistlänken, så panelen sparar det läsbart för linjens ägare. Lösenord till panelkonton lagras bara hashade.
DATA-05 Vem kan se mina linjer och kunder?
Du, kontona ovanför dig i ditt träd och admin. Andra återförsäljare och nivåerna under dig kan inte.
DATA-06 Skickar panelen e-post / meddelanden till mina kunder?
Aldrig. En linjer kunder tillhör återförsäljaren; du kontaktar dem via ditt eget system.
DATA-07 Blir jag meddelad innan en linje går ut?
På två sätt: ett dagligt sammanfattningsmejl om linjer som snart går ut (när admin har aktiverat det; 3 dagar i förväg som standard), och webhooks line.expiring / line.expired till ditt system.
Felsökning
FIXKontrollera uppifrån och ned. De flesta problem med "kan inte titta" finns bland de första 5 raderna.
FIX-01 Kunden kan inte logga in / kan inte titta
Tittare
| # | Kontrollera | Tecken | Vad du ska göra |
|---|---|---|---|
| 1 | Användarnamn / lösenord | appen rapporterar fel uppgifter | jämför med linjens formulär (skiftlägeskänsligt, inga mellanslag); skicka länken från Generate play link igen |
| 2 | Utgångsdatum | appen rapporterar Expired | förnya (LINE-06) |
| 3 | Status | Disabled / Banned | aktivera igen; vid Banned kontakta admin |
| 4 | Serveradress | kan inte ansluta | använd exakt adress och port från uppspelningslänken, och rätt http / https |
| 5 | Antal anslutningar | utkastad när någon annan börjar titta | SEC-01, SEC-02 |
| 6 | Blockerad IP | ingen linje kommer in från det nätverket | SEC-08: vänta tills blocket upphör eller be admin häva det |
| 7 | ISP-spärr / land / Allowed IPs | misslyckas bara efter byte av nätverk, på mobildata, med VPN eller vid resa | SEC-04, SEC-05, SEC-07 |
| 8 | Format | HLS- / TS-länken nekas | använd ett format som paketet tillåter (PLAY-03) |
| 9 | Blockerad app | misslyckas bara i en app | prova en annan app; SEC-09 |
FIX-02 Inloggningen fungerar och listan visas, men en kanal spelas inte upp
Tittare
FIX-03 Kanaler eller kanalgrupper saknas
Tittare
Kontrollera linjens bouquets (PKG-04, PKG-05) och kategorimallen som är tilldelad den (CAT-02). Efter en ändring, be kunden ladda om listan i appen. En kanal som admin just lagt till visas efter ungefär en halv minut; om en kanal finns i bouqueten och ingen linje ser den kan admin ha tagit den kanalen ur sändning.
FIX-04 Hackar, fryser
Tittare
Prova i tur och ordning: en annan kanal (en kanal eller alla?) → ett annat nätverk → ett annat format (HLS i stället för MPEG-TS) → en annan app. Alla kanaler misslyckas på alla nätverk → berätta för supporten användarnamnet, tidpunkten och kanalen.
FIX-05 Ingen programguide (EPG)
Tittare
FIX-06 Jag kan inte skapa en linje
FIX-07 Nedladdning av en spellista ger fel 429 eller en 404-sida
FIX-08 Jag kan inte öppna en sida i dashboarden
FIX-09 Jag får ingen e-post från panelen
E-post skickas bara när admin har konfigurerat en e-postserver och aktiverat den typen av meddelande; kontot måste ha en riktig e-postadress. Kontrollera skräppostmappen.
Ordlista
- Linje
- en tittares IPTV-prenumeration: användarnamn, lösenord, utgångsdatum, bouquets, gränser
- Användare
- ett konto som loggar in i panelen: admin, återförsäljare, underåterförsäljare
- Grupp
- behörighetsgruppen för ett panelkonto; bestämmer menyer, säljbara paket, linereglerna, testperioder
- Bouquet
- en lista med innehåll (kanaler, filmer, serier)
- Paket
- produkten som säljs: bouquets + giltighetstid + gränser + pris i krediter
- Kredit
- den förbetalda enheten som används för att köpa paket
- Test
- ett pakets testperiod
- Aktiveringskod
- en kod som en kund själv aktiverar en betald linje med
- MAG / Enigma2
- två familjer av set-top-boxar; de loggar in med MAC-adress
- Xtream Codes API
- protokollet som de flesta IPTV-appar använder (server + användarnamn + lösenord)
- M3U / XMLTV
- filformat för en spellista / en programguide
- MPEG-TS / HLS
- två strömformat
- EPG
- programguiden
- Catch-up
- att titta på ett program efter att det sänts
- Restreamer
- en linje för en partner som hämtar strömmar för att distribuera dem vidare
- Koppling
- programvara som kopplar en återförsäljares butikssystem till panelen
- Webhook
- en avisering som panelen skickar till en återförsäljares system när något händer
Ingen fråga matchar
Prova ett annat nyckelord eller en frågekod, eller rensa filtret.
Kommer du fortfarande inte vidare?
Skicka linjens användarnamn (aldrig lösenordet), när det hände, appen eller enheten och koden på den fråga du redan har provat.