İzlesene.com - Video APİ

api'ye erişim


İzlesene XML API'sine erişim sağlamak için öncelikle bir api hesabı açmanız gereklidir. Yeni api hesabı yaratmak veya var olan api hesabınızı görmek için lütfen api hesabım sayfasına giriniz. İlk defa yeni bir api hesabı yarattığınızda, size özel bir api anahtarı oluşturulacaktır. Bu anahtar, izlesene api'yi kullanmak için gereklidir.

xml sorgusu gönderme


Hesabınızı oluşturduktan sonra api'yi kullanmaya hemen başlayabilirsiniz. Video Api, izlesene video arama dizinine erişim için bir ara yüz sağlamaktadır. Bu yaklaşım ile, sorgular belirli parametreler içeren bir url dizisinden oluşur. Bütün sorgunun basit bir url ifadesi içinde yer alıyor olmasından dolayı sorgular tarayıcının adres çubuğundan, komut satırından veya belli bir url'ye http get istemi gönderebilen herhangi bir özel programın kodu içerisinden gönderilebilir.

İzlesene xml api için tüm istem url'leri aşağıdaki api hizmet url'i ile başlar:
Bu url ile belirtildiği gibi, izlesene video arama api'si için ana makine adı ‘api.izlesene.com'dur.

Sonrasında, bu api hizmet url'sinin sonuna sorgunuzu standart url formatı kullanarak tanımlayan belirli parametreleri ekleyin. Özellikle her bir parametre name=value formatında bir isim-değer ikilisinden oluşur. Eğer istenen değer boşluk, & işareti veya eşit işareti gibi özel karakterler içermekteyse, bu özel karakterleri kabul edilebilir bir karakter betimlemesine dönüştürmek için standart bir prosedür olan url encoded (url kodlu) olmalıdır. Eğer birden fazla parametre belirtmek istiyorsanız, her bir isim-değer ikilisi bir & işareti ile ayrılmalıdır. ana url parametre listesinden (?) soru işareti ile ayrılmalıdır. örnek olarak, 'api_anahtarınız''search', ve 'araba' değerlerini 'apikey', ‘action’ ve 'keyword' parametrelerine atayan bir sorgu göndermek için aşağıdaki ifadeyi kullanabilirsiniz:
Bu sorguyu veya herhangi bir rest-style sorguyu izlesene video arama motoruna göndermek için, sadece tarayıcının adres barına yapiştırın ve return tuşuna basın. benzer olarak, bu rest-style ifade aynı zamanda izlesene xml api'sine bir http get istemi gönderen diğer her hangi bir yaklaşım kullanılarak da yollanabilir. Örnek olarak, bu işlem komut satırından veya neredeyse her tür programlama dili ile yazılmış olabilen özel bir uygulamanın kodu içerisinden yapılabilir.
İzlesene Api'nin desteklediği tüm işlevlerin listesi bu sayfanın içeriğinde bulunmaktadır. Bu döküman sayesinde hangi işlemleri, hangi parametreleri kullanarak yapabileceğinizi öğrenebilirsiniz.

menüye dön

sorgu hataları


İzlesene XML API, geçersiz ve doğru olmayan api aramalarına cevap olarak hata mesajları geri göndermektedir. Her bir hata mesajı, <error> adlı tek bir künye içeren standart bir xml cevabı olarak gönderilir. Bu <error> künyesi, hatanın sayısal kodunu tanımlayan tek bir simge,kod, içerir. <error> künyesinin içeriği hatanın metinsel tanımını içerir. örnek bir hata cevabı aşağıda verilmiştir:
<?xml version="1.0" encoding="utf-8" ?>
<errors> <error>Hata Açıklaması</error> </errors>


menüye dön

xml yapısı


En basit arama sorguları bir veya boşluklarla ayrılmış daha fazla anahtar kelimeden oluşur. bu sorgulara cevap olarak, izlesene video arama hizmeti sorgu içerisindeki her bir kelimeye karşılık gelen tüm video kayıtlarını geri gönderecektir. XML yapısı olarak dönen sonuç aşağıdaki gibidir:
<videos>
<total>Bulunan Toplam Video Sayısı</total>
<video>
<videoid>Bulunan Videonun Numarası</videoid>
<videoname>Bulunan Videonun Adı</videoname>
<views>Bulunan Videonun İzlenme Sayısı</views>
<commentcount>Bulunan Videonun Yorum Sayısı</commentcount>
<votecount>Bulunan Videoya Verilen Oy Sayısı</votecount>
<thumbnail>Bulunan Videonun Resim Adresi</thumbnail>
<category>Bulunan Videonun Kategori Adı</category>
<duration>Bulunan Videonun Süresi</duration>
<link>Bulunan Videonun İzlesene Adresi</link>
<player>Player Adresi</player>
</video>

<videos> ve </videos> tagleri video arama sonuçlarının başlangıcını ve bitişini belirtir. Bulunan toplam sonuç sayısı <videos> tag'inin hemen altında bulunan <total> tag'i içinde yer alır. Artan her sonuç sayısı kadar <videos> ile </videos> tagleri arasında kalan bölüm tekrarlanmaktadır.
<video> ve </video> arasında kalan bölümde ise her bulunan sonuç için dönen video bilgileri yer almaktadır Aramanızı daha belirgin bir hale getirmek için daha fazla arama terimi kullanın.

menüye dön

sayfalama ve limit belirtme


Yaptığınız aramalarda herhangi bir sayfaya geçmek istiyorsanız aşağıdaki örnekte olduğu gibi yaptığınız sorgunun sonuna page="gitmek istediğiniz sayfa numarası" yazmanız yeterli olacaktır. (Sayfa sayıları 0'dan başlamaktadır) Aynı zamanda sonuçlarınıza her sorguda kaç sonucun gösterileceği bilgisini ayarlamak için limit="gösterilmesini istediğiniz sonuç sayısı" parametresini adres satırına eklemeniz yeterlidir. (Maksimum Limit Sayısı 20'dir.) Yukarıdaki adres, "araba" kelimesine göre bulunan sonuçlardan 16-21 arası sonuçları döndürecektir.

menüye dön

kategori belirtme


Aramanızı sadece belirli bir kategori ile sınırlamak için yapmanız gereken, &category=kategori_adi parametresini adres satırına eklemektir. Örnek kod, kategori adları ve değerleri aşağıda belirtilmiştir:
Örnek Kod:


Kategori Adları ve Değerleri:
Amatör = amator
Araba = araba
Çocuklar = cocuklar
Haber = haber
Hayvanlar = hayvanlar
Kamera Şakaları = kamerasaka
Kazalar = kazalar
Komik = komik
Müzik = muzik
Nostalji = nostalji
Oyun = oyun
Reklamlar = reklamlar
Sinema = sinema
Spor = spor
TV = tv
Ünlüler = unluler

Not: "keyword" parametresini kullanmadan sadece "category" parametresini kullanarak o kategoriye ait tüm videoları listelemeniz mümkündür.

menüye dön

arama sıralama


Arama sonuçlarını istediğiniz bir değere göre sıralamak mümkündür. "sortby=" parametresi, videonun neye göre sıralanacağını göstermektedir, "sorttype=" ise sıralamanın azalan mı yoksa artan mı olacağını belirtmek için kullanılmaktadır. Aramaları sıralamak için kullanılabilir tüm parametreler aşağıda belirtilmiştir:
&sortby=views //arama sonuçlarını izlenme sayılarına göre sıralar.
&sortby=date //arama sonuçlarını tarihe göre sıralar.

&sorttype=asc //arama sonuçlarını küçükten büyüğe doğru sıralar.
&sorttype=desc //arama sonuçlarını büyükten küçüğe doğru sıralar.


Not: arama sonuçlarını sıralayabilmek için iki parametrenin de kullanılması zorunludur.

menüye dön

tarih aralığı belirtme


Arama sonuçlarını belirlediğiniz bir tarih aralığına göre sıralayabilirsiniz. Bunu sağlamak için &start= ve &end= parametrelerini yazmanız gerekmektedir:
&start=21-08-2007 //başlangıç tarihi.
&end=21-08-2009 //bitiş tarihi.

Örnek Sorgu:
http://api.izlesene.com/api.php?apikey=api_anahtariniz&action=search&keyword=araba&category=araba&start=21-08-2007&end=21-08-2009

Not: sadece o gün içerisinde arama sonuçlarını sıralayabilmek için iki parametrenin de kullanılması zorunludur.

menüye dön

günün videoları


API'yi kullanarak İzlesene'deki günün videolarını sitenizde görüntüleyebilirsiniz. Bunu sağlamak için api adresine "&action=gununvid" parametresini yazmanız gerekmektedir. Örnek adres aşağıdadır:

menüye dön

popüler videolar


API'yi kullanarak İzlesene'deki popüler videoları sitenizde görüntüleyebilirsiniz. Bunu sağlamak için api adresine "&action=populer" parametresini yazmanız gerekmektedir. Örnek adres aşağıdadır:

menüye dön

tek video çağırmak


Api'yi kullanarak sadece tek bir videonun bilgilerini çağırabilirsiniz. Örnek olarak bunu video izleme sayfasında kullanabilirsiniz. Bunu yapabilmek için "action=play&videoid=video_numarasi" şeklinde bir parametre yollamanız gerekmektedir. "videoid" değişkenini ise önceki arama sorgunuzdan alarak parametreye gönderebilirsiniz.

menüye dön