Haber göster API

Tusul Haber göster API'si, Tusul.com'daki içeriği kullanarak kendi uygulamalarınızı ve araçlarınızı yazmanızı sağlayan REST tipi bir web servisi arayüzüdür. Bunu aslında oyun hamuruna benzetebiliriz. Bu hamura verebileceğiniz şekiller, sadece hayal gücünüzle sınırlı...

 

Temel Bilgiler

URL Yapısı

Tusul Haber web servisini kullanmak için ilk iş bir URL sorgusu (komutu) oluşturmaktır. Tüm URL'ler http://api.tusul.com/haber? ile başlar, parametrelerle devam eder. Sorgular aynen Türkçe'de soru sormak gibidir. Örneğin:
Moda kategorisindeki son 3 haberi göster --> http://api.tusul.com/haber?kategori=Moda&tane=3&format=xml

Karakter Seti

Döndürülen sonuçların karakter seti UTF-8 dir, yapacağınız uygulamaların karakter setide mutlaka UTF-8 olmalıdır.

Parametreler (Değişkenler)

Parametreler döndürülecek sonuçları özelleştirmenize yarar.

  • Varsayılan değerler parametre girmediğinizde kullanılır.
  • Vereceğiniz komut (sorgu) büyük harf/küçük harf duyarlıdır. Tüm komutlar Türkçe karakter içermeyen küçük harflerle yapılmalıdır.
    Mesela http://api.tusul.com/haber?format=xml sorgusu sonuç döndürürken, http://api.tusul.com/haber?format=XML sorgusu hiçbir sonuç döndürmez.


format: Döndürülecek sonuçların formatını seçmenizi sağlar. Varsayılan değer xml dir. Kullanabileceğiniz veri formatları json, xml ve rss yeni dir. Not: Yapacağınız sorgularda format tipini belirtmeniz tavsiye edilir.
Örnek: http://api.tusul.com/haber?format=xml

tane: Gösterilecek haber sayısını belirler. Varsayılan değeri 10'dur. 1'den 20'ye kadar tamsayı değerler kabul eder.
Örnek: http://api.tusul.com/haber?tane=7

durum: Döndürülecek haberlerin yayında veya bekleyenler durumunu seçer. Varsayılan değeri hepsi dir. hepsi, anasayfada ve bekleyen değerlerinden birini kabul eder. Örnek: http://api.tusul.com/haber?durum=anasayfada

kategori: Sadece belirli bir kategoriden haberler göstermeyi sağlar. Varsayılan değeri hepsi dir. Verebileceğiniz değer geçerli bir kategori adı olmalıdır. Önemli Not: Kategori adını girerken Türkçe karakter kullanmayınız. ü -> u , ğ -> g , ı -> i , İ -> I gibi. Kategori listesi için tıklayınız.
Örnek: http://api.tusul.com/haber?kategori=Teknoloji

tip: Döndürülen haberlerin hangi tipte olduğunu seçmenizi sağlar. Varsayılan değeri h dir. Verebileceğiniz değerler; görüş için g, inceleme için i ve bilgi için b.

kullanici: Sadece bir kullanıcının, mesela kendinizin, haberlerini göstermek için kullanılır. Verebileceğiniz değer geçerli bir Tusul kullanıcı adı olmalıdır.
Örnek: http://api.tusul.com/haber?kullanici=abc


Sorgunuzda bu parametreleri & karakteri ile bağlayarak istediğiniz kombinasyonda kullanabilirsiniz.
Örnek: http://api.tusul.com/haber?format=xml&durum=bekleyen&tane=3&kullanici=abc

Parametre Tablosu

Parametre Varsayılan Değer Alabileceği Değerler
format xml json, xml, rss
tane 10 1-20
durum hepsi hepsi, anasayfada, bekleyen
kategori hepsi geçerli bir kategori adı
tip h h, g, i ve b
kullanici tüm kullanıcılar geçerli bir kullanıcı adı




Sonuç Örnekleri

XML ve JSON formatlarındaki haber container'ı elemanları sırasıyla; baslik, aciklama, kategori, link, tarih, kullanici ve avatar dır.

XML örnek

<?xml version="1.0" encoding="utf-8"?>
<haberler>
<haber>
<baslik>Samsung'dan yeni optik sürücü</baslik>
<aciklama>Samsung Electronics, tüketicilere PC üzerinden sabit disk yardımı olmaksızın DVD oluşturmaya ve dijital içerik kaydetmeye olanak sağlayan yeni güçlü optik disk sürücüsü TruDirect SE-S204S'i tanıttı. Samsung TruDirect SE-S204S sınıfındaki diğer sürü</aciklama>
<kategori>Donanım</kategori>
<link>http://www.tusul.com/story.php?title=Samsung-dan-yeni-optik-surucu</link>
<tarih>Tue, 04 Dec 2007 16:55:28 EET</tarih>
<kullanici>iomega</kullanici>
<avatar>http://www.tusul.com/avatars/Gravatar_30.gif</avatar>
</haber>
</haberler>


JSON örnek

[{"baslik": "Samsung'dan yeni optik sürücü","aciklama": "Samsung Electronics, tüketicilere PC üzerinden sabit disk yardımı olmaksızın DVD oluşturmaya ve dijital içerik kaydetmeye olanak sağlayan yeni güçlü optik disk sürücüsü TruDirect SE-S204S'i tanıttı. Samsung TruDirect SE-S204S sınıfındaki diğer sürü","kategori": "Donanım","link": "http://www.tusul.com/story.php?title=Samsung-dan-yeni-optik-surucu","tarih": "Tue, 04 Dec 2007 16:55:28 EET","kullanici": "iomega"},{"site":"Tusul.com"}]

RSS örnek

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
<channel>
<title>Tusul.com - Sosyal Haber Sitesi</title>
<link>http://www.tusul.com</link>
<item>
<title>Paris Hilton Türkiye'ye geliyor!</title>
<description>26 Martta Türkiye'ye gelmesi beklenen, Hilton Otellerin varisi Paris Hilton, Kanal 1 tarafından düzenlenen &quot;Miss Turkey&quot; güzellik yarışmasında jüri üyeliği yapacak.</description>
<category>Magazin</category>
<link>http://www.tusul.com/story.php?title=Paris-Hilton-Turkiyeye-geliyor-1</link>
<pubDate>Thu, 20 Mar 2008 00:09:20 EET</pubDate>
<creator>sputnik</creator>
<guid>http://www.tusul.com/story.php?title=Paris-Hilton-Turkiyeye-geliyor-1</guid>
</item>
</channel>
</rss>

Sonuçları da aldık şimdi ne yapıcaz?

Artık bu Tusul'daki içeriği kullanarak istediğiniz uygulamayı, istediğiniz programlama dilinde oluşturabilirsiniz.

SSS (Sık Sorulabilecek Sorular)

Uygulamamı geliştirirken hangi programlama dilini kullanmalıyım?
İstediğiniz herhangi bir dili kullanabilirsiniz. PHP, Perl, ASP.NET, Visual Basic.NET, Ruby, C#...

Yaptığım sorgu sonuç bulamazsa ne olur?
Boş xml dosyası döner.

Gönderdiğim sorgudan "Hata Olustu" mesajı aldım bu nedir?
Tanımsız bir karakter, mesela %, # vb., kullanmış olabilirsiniz.
Büyük harf kullanmış olabilirsiniz.
Olmayan bir kategori adı girmiş olabilirsiniz. Kategori listesi için tıklayınız.

Başa Dön