Geliştiriciler için
Buradaki veriyi kendi uygulamanızda, oynatıcınızda ya da sitenizde kullanabilirsiniz. Anahtar gerekmez. Tek istediğimiz kaynak belirtmeniz ve makul bir hızda istek atmanız.
Çalma listeleri (M3U / PLS)
VLC, Kodi, IPTV kutuları ve çoğu masaüstü oynatıcı bu dosyaları doğrudan açar. Adresler istasyonların kendi yayın adresleridir; bizim sunucumuzdan geçmez.
- radyolar.m3u ve radyolar.pls: bütün istasyonlar
- radyolar.m3u?il=istanbul: bir ilde frekansı olanlar
- radyolar.m3u?tur=turk-halk-muzigi: bir tür
- İkisi birlikte de olur:
?il=ankara&tur=haber. İl ve tür adları sayfa adreslerindeki gibi küçük harfli (iller, türler).
Açık uçlar (JSON)
Hepsi GET, hepsi UTF-8 JSON. Önbellek süresi, aynı veriyi daha sık istemenin anlamsız olduğu aralık.
| Uç | Ne verir | Önbellek |
|---|---|---|
/api/katalog | Aktif ve yayın adresi olan bütün istasyonlar: slug, ad, logo, il, tür, 7 günlük dinlenme. | 5 dk |
/api/yayin/{slug} | Bir istasyonun yayın adresleri, öncelik sırasıyla; bit hızı ve HLS bilgisi. | 5 dk |
/api/np?slugs=kral-fm,metro-fm | Şu an çalan parça (sanatçı, başlık), en çok 30 istasyon. | 30 sn |
/api/istasyonlar?slugs=kral-fm,metro-fm | Verilen istasyonların kart bilgisi. | 5 dk |
/api/serit?limit=8&sehir=izmir | Şu an parçası okunabilen istasyonlar; şehir isteğe bağlı. | 30 sn |
/api/ara?q=kral | Ad, il ve tür üzerinden arama; yazım hatasına toleranslı. | 1 dk |
/api/frekans?f=92.0 | Bu frekansta hangi ilde hangi istasyon var. | 1 saat |
Örnek: curl https://radyo.io/api/np?slugs=kral-fm. Alan adları değişmez; yeni alan eklenebilir, var olan alan kaldırılmaz.
Haftalık liste widget'ı
Son 7 günde Türkiye radyolarında en çok çalan 10 parça. Sitenize koyduğunuzda saatte bir kendiliğinden yenilenir; açık ve koyu temaya uyar.
<iframe src="https://radyo.io/embed/haftalik"
title="radyo.io: haftanın en çok çalanları"
width="100%" height="420" loading="lazy" style="border:0"></iframe>Nasıl göründüğü: /embed/haftalik. Tek bir istasyonun mini oynatıcısı da yerleştirilebilir:
<iframe src="https://radyo.io/embed/kral-fm"
title="Kral FM canlı" width="100%" height="120"
loading="lazy" allow="autoplay" style="border:0"></iframe>Kullanım koşulları
- Kaynak belirtin. Veriyi gösterdiğiniz yerde radyo.io'ya bağlantı verin.
- Makul hız. Dakikada 60 isteğin üstü ve önbellek sürelerinin altına inen tekrarlar engellenebilir.
- Yayınlar istasyonların. Biz dizin tutuyoruz; yayın hakları ve içerik istasyona aittir.
- Aracı adresler (/s/) yalnızca site oynatıcısı içindir. Listelerde ham adres verilir; aracıyı toplu kullanmayın.
Sorunuz ya da isteğiniz varsa iletişim sayfasından yazın. Veri kaynakları burada.