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

0
FZ
Daha önce bahsettiğimiz yazboz.com ile ilgili yeni bir gelişmeyi paylaşmak istiyoruz: sistemi kendi uygulamalarında kullanmak isteyen araştırmacılar için bir API hazırlandı.

yazboz.com geliştiricileri Can Altıneller ve Özgür Oktay'ın hazırladığı API belgesinin ilk sürümünü FM takipçisi bilgisayarcılarla paylaşmak istiyoruz:

YazBoz.com'da biriktirdiğiz verileri bilim insanları ve uygulama geliştirmek isteyen herkesle paylaşabilmek için bir API geliştirdik. Bugüne kadar Yazboz'u inceleyen yapay zekâ araştırmacıları, dilbilimciler ve bilişsel bilimciler yazboz verilerinin kendi çalışmalarına önemli katkılarda bulunabileceğini düşündüler. YAZBOZ API’nin bu ilk sürümü ile bilim insanları ve geliştiriciler yeni uygulamalar yapabilecekler. Uygulamalar çoğaldıkça ve geliştikçe biz de YAZBOZ API yi geliştireceğiz.
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.

Görüşler

0
ekimkaya
Can ve Özgür'ü kutluyorum. Botego olarak en kısa sürede bu harika birikimden faydalanan bir uygulama geliştirme niyetindeyiz. Anlama dayalı web teknolojileri geliştiğinde Yazboz Türkçe alanında kayda değer bir birikimle "hazır bekliyor" olacak gibi görünüyor.
0
FZ
Aklıma WordNet ile ilgili şu tür çalışmalar geldi.

Tabii pek değerli hocalarımızın pek değerli üniversitelerde yukarıdakine benzer şekilde "haydi hemen şu linke tıklayın ve download edin" gibi bir şey sunmamaları biraz üzücü (yanılıyorsam düzeltin).

İçimden bir ses tıpkı Zemberek'e benzer şekilde WordNet gibi bir yapının da Türkçe için akademisyenlerin dünyasından uzak olarak profesyonel bilgisayarcıların marifeti ile gerçekleştirilebileceğini söylüyor (yazboz.com'daki veriler her ne kadar şu anda WordNet tarzında olmasa da birkaç kişinin birkaç aylık düzgün bir çalışması ile belli ölçüde işe yarar bir Türkçe anlamsal çizge oluşturulup kolayca download edilebilir halde tüm ticari ve hobi ve akademik amaçlar için tek tıklama ile download edilebilir halde sunulabilir).
Görüş belirtmek için giriş yapın...

İlgili Yazılar

SPAM savaşları - SPAM tarama

cayfer

Kendi gözlemlerimize ve çeşitli kaynaklara göre e-posta trafiğinin yarısından fazlasını SPAM mesajlar oluşturuyor. Buna katlanmak gittikçe zorlaşıyor. SPAM ile savaşta çok çeşitli yöntemler kullanılıyor. İşte size bir yöntem daha...

İşletim Sistemleri Videoları

DemensMagnet

Birçok dağıtımın ve arada Vista'nın da videolarının bulunduğu http://osvids.com herkesin yer imlerinde bulunması gereken bir site. Bu yazı yazılırken SUSE Linux Enterprise Desktop 10 video arşivine eklenmişti.

Pythoncard çıktı

gencbeyin

Pythoncard çıktı! :-))
Eski Macintoshcular belki bilirler hypercard apple üstünde grafik arayüzlü programlar geliştirmek için harika bir araçtı. Bundan esinlenerek ortaya atılan bir proje, python skriptlerin grafik arayüz ile ilgili tanımlamalarını ayrı bir kaynak dosyasında saklıyarak, zahmetsiz ve kolay okunur uygulama geliştirilmesine olanak tanıyor.
Ayrıntı için bakınız... Tabii ki bu bir açık sistem projesidir ve katkılarınızı bekliyor, ancak o zaman mükemmeliğe ulaşacak! Bu işten anlayanlar hiç durmasın ...
Stephen Figgins'in bir yazısından...

Satılık Tapınak

ctengiz

Borland'dan gelen son haberlere göre, Borland ALM (Application Lifecycle Management) pazarında yoğunlaşmak istediği için efsanevi Delphi'yi de içeren IDE ürünlerini satılığa çıkardı.

Google query API

FZ

Efsanevi arama motoru Google geçen Perşembe günü yaptığı açıklama ile programcıların kendi programları içinden doğrudan arama tarama servislerine erişmelerini sağlayan APIyi ve bedavaya sunulan servisinin beta sürümünü duyurdu.