Xtream API Nasıl Çalışır? IPTV Oturumlarının Mantığı
Euro Prime TV Editör Ekibi
Xtream API, IPTV sağlayıcılarının kanal listesi, film arşivi ve program rehberi gibi verileri oynatıcı uygulamalarına aktarmak için kullandığı arayüzdür. Kullanıcı tarafında görünen tarafı yalnızca sunucu adresi, kullanıcı adı ve parola alanlarıdır.
Bu yazıda API'nin panel, oynatıcı ve kullanıcı arasındaki rolünü, oturum akışını, veri türlerini ve hesap güvenliğiyle ilgili dikkat edilecek noktaları anlatıyoruz.
Xtream API nedir?
API (uygulama programlama arayüzü), iki yazılımın belirli kurallarla konuşmasını sağlar. Xtream API örneğinde bir taraf sağlayıcının sunucusu, diğer taraf oynatıcı uygulamasıdır.
Oynatıcı, sunucuya tanımlı bir istek gönderir ve yanıt olarak kanal listesi, kategori bilgisi, film ve dizi kataloğu ile rehber verisini alır. Kullanıcı arayüzde yalnızca sonucu görür.
Bu yapı, kullanıcı için pratiklik sağlar: tek bir oturum bilgisiyle kanal, arşiv ve rehber aynı yerden yönetilir. Alternatif liste biçimi M3U ile karşılaştırması M3U ve Xtream Codes yazısındadır.
Panel, API ve oynatıcı ilişkisi
Sağlayıcı tarafında bir yönetim paneli bulunur. Panel; kullanıcı hesaplarını, paketleri, kanal kaynaklarını ve sunucu dağılımını yönetir. API ise bu veriyi dışarıya açan katmandır.
| Katman | Görevi | Kullanıcıya etkisi |
|---|---|---|
| Panel | Hesap, paket ve kanal yönetimi | Paket değişikliği ve yeni kanallar |
| API | Veriyi oynatıcıya iletir | Liste ve rehber görünümü |
| Oynatıcı | Veriyi gösterir, yayını oynatır | Günlük kullanım deneyimi |
| Yayın sunucusu | Akışı iletir | Yayın kalitesi ve akıcılık |
Sorun yaşandığında hangi katmanın etkilendiğini bilmek teşhisi hızlandırır. Liste gelmiyorsa oturum veya API; liste gelip yayın açılmıyorsa yayın sunucusu incelenmelidir.
Oturum akışı adım adım
Oturum açma süreci birkaç adımdan oluşur. Kurulumda bu akış birkaç saniye içinde tamamlanır.
-
1. Sunucu adresi girilir: sağlayıcıdan gelen adres tanımlanır.
-
2. Kimlik bilgileri gönderilir: kullanıcı adı ve parola ile oturum istenir.
-
3. Oturum doğrulanır: paket durumu ve eş zamanlı izleme hakkı kontrol edilir.
-
4. Kategoriler alınır: kanal, film ve dizi kategorileri listelenir.
-
5. Veri indirilir: liste ve rehber oynatıcıya aktarılır.
-
6. Yayın başlatılır: kanal seçildiğinde akış adresi oturum bilgisiyle istenir.
-
Kurulum sonrasında liste güncellemeleri aynı akış üzerinden alınır; bu nedenle yeni kanallar genellikle uygulama yeniden başlatıldığında görünür.
Kanal, arşiv ve rehber verisi
API üzerinden alınan veri tek tip değildir. Canlı kanallar, arşiv içerikleri ve rehber verisi farklı isteklerle alınır.
-
Canlı kanallar: kategori ve kanal adı bilgisiyle birlikte gelir.
-
Film arşivi: film adı, yılı ve bazen kapağı ile listelenir; ayrıntılar VOD nedir yazısındadır.
-
Dizi arşivi: sezon ve bölüm yapısı ayrı isteklerle alınır.
-
Rehber verisi: program bilgisi kanal kimlikleriyle eşleştirilir; ayrıntılar EPG nedir yazısındadır.
Veri hacmi büyüdükçe liste yükleme süresi uzar. Çok sayıda kanal içeren aboneliklerde oynatıcı ayarlarından kategori gizleme veya favori listesi kullanmak yükleme süresini kısaltır.
Güvenlik ve hesap paylaşımı
Oturum bilgileri, aboneliğe erişimin tek anahtarıdır. Paylaşıldığında hesap başka cihazlarda kullanılabilir ve eş zamanlı izleme hakkı hızla tükenir.
-
Bilgi paylaşımı: sunucu adresi, kullanıcı adı ve parola üçüncü kişilerle paylaşılmamalıdır.
-
Eş zamanlı izleme: aynı anda izin verilen cihaz sayısı pakete bağlıdır.
-
Cihaz değişimi: cihaz değiştiğinde eski cihazın oturumu kapatılmalıdır.
-
Şüpheli hareket: hesapta beklenmeyen kesintiler varsa sağlayıcıya bilgi verilmelidir.
Eş zamanlı izleme hakkı ve cihaz sayısı seçimi tek cihaz ve çoklu cihaz yazısında, sağlayıcı değerlendirme ölçütleri sağlayıcı seçimi yazısında ele alınmıştır.
Sık görülen sorunlar
Oturum kaynaklı sorunların çoğu kimlik bilgisi veya bağlantı kaynaklıdır.
-
Giriş başarısız: kullanıcı adı ve parola büyük-küçük harf duyarlıdır; kopyalama hatası kontrol edilmelidir.
-
Liste boş: paket süresi veya eş zamanlı izleme sınırı aşılmış olabilir.
-
Arşiv görünmüyor: paket kapsamı ya da oynatıcı sürümü etkili olabilir.
-
Rehber boş: kaynak tanımı ve saat dilimi ayarı gözden geçirilmelidir.
Sık sorulan sorular
Xtream API nedir?
Sağlayıcının kanal, arşiv ve rehber verisini oynatıcı uygulamalarına aktarmak için kullandığı arayüzdür; kullanıcı tarafında oturum bilgileriyle çalışır.
Xtream Codes ile Xtream API aynı şey mi?
Xtream Codes panel altyapısını, API ise bu altyapının veri aktarım katmanını tanımlar; kullanıcı açısından ikisi birlikte çalışır.
Oturum bilgilerim paylaşılırsa ne olur?
Hesap başka cihazlarda kullanılabilir ve eş zamanlı izleme hakkı tükenerek yayın kesilebilir.
Liste güncellemesi nasıl olur?
Uygulama yeniden açıldığında liste ve rehber verisi aynı oturum üzerinden yenilenir.
Giriş başarısız olursa ne yapmalıyım?
Kullanıcı adı ve parolanın büyük-küçük harf uyumunu kontrol edin, kopyalama hatası olup olmadığını denetleyin.
Kaynaklar
Bu yazıdaki teknik ifadeler için resmî kaynaklara başvurulmuştur: Xtream Codes – Panel ve API dokümantasyonu, ITU-T Y.1901 – IPTV hizmetleri için gereksinimler, RFC 8216 – HTTP Live Streaming. Bu kaynaklar yayın teknolojisinin genel işleyişini açıklar; hizmet kapsamı ve cihaz desteği için ilgili paket ve destek sayfalarına bakabilirsiniz.
Etiketler:
XCIPTV Nasıl Kurulur? Adım Adım Kurulum Rehberi
