YazBoz API'nin İlk Sürümü Çıktı

Tüm sorularınız için http://www.yazboz.com/hakkinda sayfasından "bize ulaşın"a tıklayınız.

[login metodu]
http://www.yazboz.com/ybzapi?op=login&user=USERNAME&pass=PASSWORD

YAZBOZ API'yi kullanmadan önce, bir yazboz.com hesabına ve parolaya ihtiyacınız var. http://www.yazboz.com/kaydol adresinden kayıt olabilirsiniz. API sorgularını kullanmadan önce API'ye login olmanız gerekiyor. Bunun için:

Tarayıcınız vasıtası ile veya herhangi bir http client ile gönderebilirsiniz. (commons http client, curl vs.)

Yukarıdaki bağlantı size JSON olarak bir jeton (token) döndürür. Bu jeton ve kullanıcı adınız daha sonra yapacağınız tüm sorgularda bulunmalıdır.

Bunu yapmamızın sebebi çerez (cookie) desteği olmayan istemcilerin de kullanılabilmesini sağlamaktır. Böylece uygulama geliştirmek daha kolay olur. Örnek jeton (tırnak işaretleri jetona dâhil değildir): 68e04f2s7fvki13po9drna

Bu jeton ve kullanıcı isminizi diğer tüm sorgulara yapıştırmamız gerekiyor. Örneğin kullanıcı isminiz can ise, yapacağınız tüm sorguların sonunda:

&user=can&token=68e04f2s7fvki13po9drna olmalıdır.

Ayrıca API ile işimiz bittiği zaman logout olursak güzel olur.

Hata Mesajları

Herhangi bir sorgu sonucunda API size hata mesajları dönebilir.

Eğer herhangi bir sorgu sonucu "notauthenticated" dönerse, tekrar login olmanız gerekir.

Eğer "sessiontimeout" dönerse oturumunuz zaman aşımına uğradı demektir. Tekrar login olmanız gerekir. Zamanaşımı süresi 30 dakikadır.

Eğer "fail" dönerse, bir parametre göndermeyi unuttunuz demektir!

Hata mesajları JSON formatındadır. Mesajların başlangıcındaki ve sonundaki tırnak işaretleri çeşitli javascript kütüphanelerinin geri dönen mesajı JSON olarak işleyebilmesini sağlar.

[logout metodu]
http://www.yazboz.com/ybzapi?op=logout&user=USERNAME&token=TOKEN

Yukarıdaki URL oturumunuzun sona ermesini sağlar. Logout olmak için de kullanıcı ismi ve jeton gereklidir. Lütfen yazdığınız uygulamada bu özelliği kullanınız.

Veri İşleme Metodları

Şu anda YAZBOZ API'nin desteklediği 6 metod var. Bunlar:

[edgesOf]
http://www.yazboz.com/ybzapi?op=edgesOf&word=WORD&user=USERNAME&token=TOKEN

Örnek olarak:
http://www.yazboz.com/ybzapi?op=edgesOf&word=bilgisayar&user=USERNAME&token=TOKEN

gönderirsek yazboz bize:

["antivirüs", "soket", "daktilo", "oyun", "kelepir", "bayt", "abaküs", "data", "disket", "işlemci", "teknolojik", "yazıcı", "konsol", "makina", "virüs", "toplama", "işlem", "yazılım", "taşınabilir"]

verecek.

YAZBOZ API JSON konuşmaktadır.

[ara]
http://www.yazboz.com/ybzapi?op=ara&word=WORD&user=USERNAME&token=TOKEN

Örnek olarak:

http://www.yazboz.com/ybzapi?op=ara&word=bilgi&user=USERNAME&token=TOKEN

gönderirsek yazboz bize:

["bilgisizlik", "bilgin", "bilgilendirme", "bilgili", "bilgi", "bilgisayar", "bilgisi olan"]

verecek.

[frqOfEdge]

http://www.yazboz.com/ybzapi?op=frqOfEdge&src=SRC&dst=DST&user=USERNAME&token=TOKEN

Örnek olarak:

http://www.yazboz.com/ybzapi?op=frqOfEdge&src=disket&dst=bilgisayar&user=USERNAME&token=TOKEN

gönderirsek yazboz bize:

"3"

verecek.

Verilen değer aynı bağcığın kaç kişi tarafından girilmiş olduğunu gösterir.

src kaynak kelime dst ise hedef kelimedir ve bilgisayar -> disket ile disket->bilgisayar aynı değildir.

[frqOfWordAsSrc]

http://www.yazboz.com/ybzapi?op=frqOfWordAsSrc&word=WORD&user=USERNAME&token=TOKEN

Bu metot ile bir kelimenin yazboz'dada kaç kere geçtiğini öğrenebilirsiniz.

Dikkat edilmesi gereken nokta, verilen değerin kelimenin kaynak kelime olarak kaç kere geçtiğinin sayısı olduğudur.

Örnek olarak:

http://www.yazboz.com/ybzapi?op=frqOfWordAsSrc&word=bilgisayar&user=USERNAME&token=TOKEN gönderirsek yazboz bize:

"6"

verecek

[frqOfWordAsDst]

http://www.yazboz.com/ybzapi?op=frqOfWordAsDst&word=WORD&user=USERNAME&token=TOKEN

Bu metot ile bir kelimenin yazboz'da kaç kere geçtiğini öğrenebilirsiniz.

Dikkat edilmesi gereken nokta, verilen değerin kelimenin hedef kelime olarak kaç kere geçtiğinin sayısı olduğudur. Bunu yapmamızdaki sebep kaynak kelimenin rastgele olarak seçilmesidir.

Örnek olarak:

http://www.yazboz.com/ybzapi?op=frqOfWordAsDst&word=bilgisayar&user=USERNAME&token=TOKEN

gönderirsek yazboz bize:

"25"

verecek. [numlink]

http://www.yazboz.com/ybzapi?op=numlink&user=USERNAME&token=TOKEN

Yazboz’da biriken toplam bağcık sayısını verir. Bu rakam kullanıcıların girdiği toplam bağcık sayısı olup tekil bağcık sayısı değildir.

[numword]

http://www.yazboz.com/ybzapi?op=numword&user=USERNAME&token=TOKEN

Yazboz’da biriken tekil (unique) kelime sayısını verir. Bu değerin amacı herhangi bir kelimenin kaç kere geçtiğini frekans olarak hesaplayabilmektir.

Eğer ilgilendiğiniz başka metodlar varsa lütfen bize bildirin. Zaman ve sunucu kaynaklarımız uygun olduğu sürece yapmaya çalışacağız.

YAZBOZ API akademik amaçlar için kullanılmak için geliştirilmiştir. Lütfen başka bir amaçla kullanmayınız.

Kaynak göstermek kaydı ile verileri kullanabilir veya YAZBOZ API kullanarak çalışan uygulamalar geliştirebilirsiniz.

YAZBOZ, ölçeklenebilir şekilde geliştirilmiş, çizge (graph) tabanlı verileri saklayabilen, bu tür işler için optimize edilmiş YBDBdoo üzerinde çalışmaktadır.