İnternet radyosunda şu an ne çalıyor.
Tuneping, on binlerce internet radyosu istasyonunun canlı bir dizinini tutar ve bunu çalma geçmişi ve istek listesi bildirimleriyle birlikte bir JSON API olarak sunar. Her oynatıcının gösterdiği başlık satırını okuruz, sesi asla.
Deneyin canlı, gerçek dizinde · anahtarsız 2 req/s
API belgelerini okuyunCanlı durumGET https://api.tuneping.com/v1/now-playing/search
01 · Ne elde edersiniz
Altı özellik, tek API
Canlı arama
anahtar gerekmez“Şu an Blue Monday'i kim çalıyor?” diye sorun, istasyonları alın: bulanık eşleşmeli, aksanlara duyarsız, her eşleşme için bir güven düzeyiyle.
GET /v1/now-playing/search
Favoriler için şu an çalan
anahtar gerekmezBir grup istasyon kimliği için tek bir istek; güncel başlığı, ilk ne zaman görüldüğünü ve en son ne zaman doğrulandığını döndürür.
GET /v1/now-playing?station_ids=…
Çalma geçmişi
developer +Bir istasyonun ne çaldığı, tahmini başlangıç ve bitiş zamanlarıyla: Developer'da 7 gün, Pro ve üzerinde 12 ay.
GET /v1/stations/{id}/history
İstek listesi bildirimleri
developer +Bir şarkı veya sanatçı belirtin; bir istasyon onu çalmaya başladığı anda haberiniz olsun. Sorgulayarak veya SSE üzerinden akış olarak alın; Pro ve üzerinde webhook ile de alabilirsiniz.
SSE · webhook
Parçalar ve sanatçılar
anahtar gerekmezBaşlıklar normalleştirilir ve mümkün olduğunda MusicBrainz kimliklerine bağlanır; böylece parça veya sanatçı başına çalma sayısını hesaplayabilirsiniz.
trk_… · art_… · MusicBrainz ids
İstasyon dizini
anahtar gerekmezÜlkesi, codec'i ve başlıklarını okumak için kullandığımız yöntemle birlikte on binlerce istasyon; aranabilir ve filtrelenebilir.
GET /v1/stations
02 · Nasıl çalışır
Tek bir satır okuruz
Her yayın akışı, güncel başlığı, yani oynatıcınızın gösterdiği metni taşıyan küçük bir yan kanal içerir. Tuneping bunu okur, başka hiçbir şeyi değil.
Dizin
Topluluk tarafından sürdürülen herkese açık Radio Browser dizininden başlarız ve her istasyonu bir kez yoklayarak başlığının yayımlandığı en ucuz yeri buluruz: yayın sunucusunun herkese açık durum uç noktası ya da akış içi meta veri bloğu.
Nazikçe sorgulama
Her 20 ila 60 saniyede bir, istasyon başına birkaç yüz bayttan yaklaşık 16 KB'a kadar veri okur, ardından bağlantıyı kapatırız. Sunucu başına aynı anda en fazla iki bağlantı; robots.txt ve Retry-After dikkate alınır. Yayıncılar için ayrıntılar.
Normalleştirme
Başlıklar sanatçı ve parça olarak ayrılır; şarkı, istasyon tanıtımı, program veya reklam olarak sınıflandırılır; metin izin verdiğinde MusicBrainz ile eşleştirilir ve açıkça belirtilen bir belirsizlikle bir başlangıç zamanı alır.
Sunma
ETag'ler, hız sınırı başlıkları ve uç önbelleğe alma içeren yalın bir JSON API; bir OpenAPI dosyası ve API başvurusu ile tanımlanmıştır.
Yalnızca meta veri · tek bir sorgulamadan sakladığımız her şey
StreamTitle='Madonna - Holiday';
Çevresindeki ses, geldiği anda atılır. Kayıt yok, önizleme yok, parmak izi tanıma yok, hiçbir şey aktarılmaz. Sorgulayıcı ne yapar.
03 · Dürüst sınırlar
Neyi yapamaz
Pek çok istasyon başlık göndermez; yalnızca kendi adını ya da sloganlarını gönderir. Bunları işaretleriz ve veri uydurmayız; durum sayfası kaç istasyonun canlı meta veri sağladığını gösterir.
Bir sorgulamada görülen değişiklik, önceki aralığın herhangi bir anında gerçekleşmiştir. Her çalma start_uncertainty_seconds taşır; yönteme bağlı olarak ±10 ila 30 s bekleyin.
İstasyon meta verisinden algılama, ses tanımaya göre daha az eksiksizdir ve hiçbir zaman onaylı bir çalma sayısı değildir. Kanıt olarak sunarken “istasyon meta verisinden algılanmıştır” deyin.
Yayın akışları her gün taşınır, kapanır ve el değiştirir. Bir istasyon istediği zaman çıkış talep edebilir ve 24 saat içinde API'den kaldırılır.
İstasyon adları metin olarak döndürülür; logolar ve görseller hizmetin parçası değildir.
04 · Planlar
Planlar
Self servis, istediğiniz zaman iptal. Yıllık ödeme, aylık ücretin on katıdır. Fiyatlara, uygulandığı yerlerde KDV dahildir; Stripe CHF, EUR, USD, GBP veya JPY ile faturalandırır. Business ve yıllık ödeme için: [email protected].
Free
0 €
süresiz
- Günde 1.000 istek
- 2 req/s, anlık en fazla 5
- Canlı arama, toplu şu an çalan (20 istasyon), istasyon dizini
- Parça ve sanatçı sorguları
- E-posta doğrulamasından sonra 1 API anahtarı
- “Data by Tuneping” gösterir
Developer
29 € / ay
veya yılda 290 €
- Ayda 100.000 istek
- 10 req/s, anlık en fazla 20
- 100 istasyona kadar toplu şu an çalan
- 7 günlük çalma geçmişi
- 10 istek listesi, sorgulayarak veya SSE ile
- 2 iş günü içinde e-posta desteği
- Kaynak gösterme gerekmez
Pro
99 € / ay
veya yılda 990 €
- Ayda 1.000.000 istek
- 50 req/s, anlık en fazla 100
- 12 aylık çalma geçmişi
- İstasyon, parça ve sanatçı filtreli 5 webhook uç noktası
- 100 istek listesi, webhook ile de iletilir
- Parça ve sanatçı başına çalma raporları
- 5 API anahtarı, 1 iş günü içinde e-posta desteği
Business
349 €'dan başlayan / ay
yıllık fatura, özel hacim
- Özel istek hacmi ve hızı
- 12 aylık geçmiş, ötesinde toplu veriler
- 20 webhook uç noktası, filtresiz tam akışa izin verilir
- 1.000 istek listesi, 20 SSE bağlantısı
- CSV / JSONL dışa aktarımları
- Okumalarda aylık %99,5 SLA, adı belirli bir irtibat kişisi
05 · Yayıncılar
Bir istasyon mu işletiyorsunuz?
Günlüklerinizde TunepingBot/0.1 (+https://tuneping.com/bot) görebilirsiniz. Her 20 ila 60 saniyede bir herkese açık durum uç noktanızı ya da yayın akışınızın ilk meta veri bloğunu okur, fazlasını değil. Adresleri ve 24 saat içinde geçerli olan üç çıkış yolu tek bir sayfada. Sorular için: [email protected].