Merhaba Arkadaşlar;
YAHOO! Geliştirici Ağındaki API’leri tanıtmaya Müzik API’si ile başlıyorum.
Kısaca API’yi açıklayayım. API(Application Interface) yani uygulama arayüzü’dür. API’ler ile bir programa ek özellikler katabileceğiniz veya size sunulan Interface’e uygun kodlama yaparak çıktılarını alıp yeni bir uygulamanızda kullanabilirsiniz. Bizimde Y! API’s tarafında bu olacaktır. Örneğin sitemizde bir arama bölümü var. Y! BOSS API”ni alacağız veya Y! Music API’ni bir seçenek daha ekleyeceğiz arama seçenekleri arasına Y! Music’de ara diye ve bizim arama kutucuğumuza yazılan bir data’yı YAHOO!’nun artık Y! diyeceğim veri tabanında arıyabileceksiniz.
Peki neden Y! veya diğer kişier API veriyorlar? Nedeni güvenlik tabikide. Size XML çıktı üretmese veya web servislerini kullanmasa o zaman her geliştirici Y!’nun database server’larına connection açacaktı. Buda çok büyük bir güvenlik açığı oluşturmaktadır. Herkes %100 iyi niyetli olsa bile hatalı bir delete sorgusu bütün Y! Music’in yedek alınmayan son bir kaç saatlik database’ne mal olur. Buda göze alınamayacak kadar büyük bir tehlike. Bundan çok hizmeti kullanan kişilerin güvenliğide geliyor. Yani neden bir başkası sizin ne dinlediğinizi nelerden hoşlandığınızı v.s. öğrensin ki? Bu ve daha sayamayacağım kadar çok geçerli sebebten dolayı API’ler hayatımıza girmektedir.
Eğer Y!’nun bir hizmetinin API’ni kullanacaksanız. Y! bunun için kayıt olmanızı istiyor bu kayıt sonucu size bir API ID’si veriyor. Bu numara sadece size özeldir. Çünkü bunu verirken sizden bir de domain istiyor. Mesela bizim yaptığımız uygulamalar benim Y! Developer ID’min domain access’i http://yahoo.nets2.com/Yahoo adresidir. Bu adresten başka o ID çalışmayacaktır. Çok güzel düşünülmüş bir sistem. Böylece kimse kimsenin API’sini kullanamıyor. Herkes kendine bir API almak zorunda kalıyor. Ücretli olmadığından dolayıda bir sorun yok. İsteyen herkes alabilir.
Sınırlamaya baktığımızda her IP(İnternet Protokol Numarası) için günlük 5,000 sorgu ile sınırlamaktadır. Y! BOSS API’de sınırsızdır. BOSS API’ni ileride tanıtacağım. Şimdi Y! Music API’ni tanımaya başlayalım.
İlk olarak URL standartına bir baklalım. Y! Music API’nin URL standartı şimdilik şu şekildedir;
http://[bölge].music.yahooapis.com/[hizmet]/v1/[kaynak]
[bölge] olan yere biz şimdilik Y! Music Türkiye olmadığından us yazacağız. (United States)
[hizmet] dediğimiz yere aldığımız hizmetin hangi öğesini kullanacaksak onu yazıyoruz mesela Music hizmetinin list öğesi gibi. Neyse onlarada değineceğiz.
[kaynak] yerine ise mesela list alıyorsak onun populer list’i var. Bunu almak istiyorsak US Bölgesinin / Music hizmetinin list öğesinin / populer özelliğini yazıyoruz yani buna göre şu link’in çalışması gerekiyor.
http://us.music.yahooapis.com/artist/v1/list/published/popular?appid=[yourappidhere]
Şimdi burada bir tane daha özellik dikkatimi çekiyor. [YourAppIDHere] bölümünde ise denildiği gibi API ID’mizi oraya yapıştırıyoruz. Son hali ise şöyle oluyor. Benim API ID’me göre;
http://us.music.yahooapis.com/artist/v1/list/published/popular?appid=f3tklz7IkY017gQuBIg855j2I3XipeM77aQf
Şimdi karşınıza bir XML yapı gelmesi gerekiyor. Bu XML yapısınıda öğreneceğiz. Hangi elemanlar’da neyi okuyacağımızı v.s. Bu XML yapı Y! Top 100 Listesini vermektedir. Belirli süre aralıklarla güncellenmektedir bu liste ona göre sizde sitenizde kullanabilir veya biraz daha komplike düşünürsek siz bir oylama yaptırarak liste içerisinde yukarı aşağıya oynama yapabilirsiniz. Tabi size gelen XML üzerinde değil. Geldikten sonra sizin oluşturacağınız 2. bir xml yapı üzerinde.
Bir sonraki yazımca Y! Music API’ne devam edeceğiz. Sıradaki derste Önemli Parametreleri anlatacağım. Dersin sonunda da hep beraber çalışan bir örnek yapıp göreceğiz.
Saygılar,
Hakan DAMAR
