YAYİNİ.NET API, radyo istasyonları veritabanına kapsamlı programlı erişim sağlar.
Bu API ile radyo istasyonları listesi, kategori bilgileri, kullanıcı işlemleri,
dinleme istatistikleri ve daha fazlasını yönetebilirsiniz.
Önemli: Tüm API çağrıları HTTPS üzerinden yapılmalıdır.
HTTP çağrıları güvenlik nedeniyle reddedilir.
Taban URL
http://yayini.net/api/
Genel Yanıt Formatı
Tüm API yanıtları aşağıdaki JSON formatını kullanır:
Mevcut API sürümünde, genel endpointler kimlik doğrulama gerektirmez.
Ancak kullanıcıya özel işlemler için giriş yapılması gerekir.
Genel Endpointler (Kimlik Doğrulama Gerektirmez)
İstasyon listesi
Kategori listesi
Arama işlemleri
Genel istatistikler
Korumalı Endpointler (Giriş Gerektirir)
Favori işlemleri
Kullanıcı profili
Dinleme geçmişi
Dinleme oturum yönetimi
Gelecek Sürümler: API anahtarı tabanlı kimlik doğrulama sistemi eklenecektir.
İstek Limitleri
API'nin istikrarlı çalışması için istek limitleri uygulanmaktadır.
Bu limitler IP adresi bazında hesaplanır.
Anonim Kullanıcılar
60 istek/dakika
IP bazında limitlenir
Kayıtlı Kullanıcılar
120 istek/dakika
Kullanıcı bazında limitlenir
Limit Aşımı Durumu
İstek limiti aşıldığında aşağıdaki yanıt alınır:
HTTP/1.1 429 Too Many Requests
{
"success": false,
"message": "Çok fazla istek. Lütfen bir dakika sonra tekrar deneyin.",
"error_code": "RATE_LIMIT_EXCEEDED",
"retry_after": 60
}
Endpoint Özeti
API'de mevcut olan tüm endpointlerin genel listesi:
Metod
Endpoint
Açıklama
Auth
GET
/api/?endpoint=stations
Radyo istasyonlarını listeler
GET
/api/?endpoint=station&id={id}
Tek istasyon detayı
GET
/api/?endpoint=categories
Kategori listesi
GET
/api/?endpoint=popular
Popüler istasyonlar
GET
/api/?endpoint=newest
Yeni eklenen istasyonlar
GET
/api/?endpoint=search&q={query}
İstasyon arama
GET
/api/?endpoint=genres
Müzik türleri
GET
/api/?endpoint=countries
Ülke listesi
GET
/api/?endpoint=stats
Genel istatistikler
GET
/api/random-station.php
Rastgele istasyon
GET
/api/station-status.php
İstasyon durumu
POST
/api/start-listening.php
Dinleme başlat
POST
/api/end-listening.php
Dinleme sonlandır
GET
/api/get-favorites.php
Favori listesi
POST
/api/toggle-favorite.php
Favori ekle/çıkar
GET
/api/get-user-profile.php
Kullanıcı profili
GET
/api/get-user-history.php
Dinleme geçmişi
POST
/api/clear-history.php
Geçmişi temizle
Ana Endpointler
API'nin temel endpointleri ve kullanım detayları:
GET
İstasyonlar Listesi
GET http://yayini.net/api/?endpoint=stations
Tüm aktif radyo istasyonlarını sayfalama ile listeler.
Parametreler
Parametre
Tip
Zorunlu
Açıklama
page
integer
Opsiyonel
Sayfa numarası (varsayılan: 1)
limit
integer
Opsiyonel
Sayfa başına kayıt (1-50, varsayılan: 20)
genre
string
Opsiyonel
Müzik türüne göre filtrele
country
string
Opsiyonel
Ülkeye göre filtrele
language
string
Opsiyonel
Dile göre filtrele
Örnek İstek
curl -X GET "http://yayini.net/api/?endpoint=stations&page=1&limit=10&genre=pop"