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

Software Quest Yazılım Yarışması

FZ

Bantgenişliği takip sistemi, Internet tabanlı farklı bir satranç oyunu, elektronik simülasyon sistemleri, grafik tanıma sistemleri, Civilisation benzeri oyunlar...

Yazılımcı gençlerin Bilkent Üniversitesi'nin düzenlediği Software Quest yarışmasında neler geliştirdiklerini görmek istiyorsanız buraya bakabiliriniz.

JavaScript ile çizim yapmanın kolay yolu: <canvas>

cbc

canvas, Apple'ın Dashboard ile çıkarttığı bir HTML elemanı.

Safari ve Gecko 1.8 tabanlı tarayıcıların (mesela Firefox) da desteklediği bu elemana son destek Google'dan geldi.

FINDIK - Herkese Açık Filtre

anonim

İçerik analizi ve filtreleme alanında yeni bir enerji yiyeceği, yolculuğuna başladı. Bugün 0.2g sürümüyle erişebileceğiniz FINDIK, benzer kapsamdaki diğer yazılımlar ile çekişmeli bir yarış içerisine girmeye hazırlanırken, Türkiye’deki açık kaynak gönüllülerinin yardımlarını bekliyor.

NZemberek 0.1 Çıktı

FZ

Zemberek blogundaki habere göre .NET için C# ile geliştirilen açık ve özgür kodlu yazım kılavuzu NZemberek çıktı:

"17 Kasım 2006'da Mehmet'e gönderdiğim bir e-posta ile başlayan çalışmamızın ilk ürününü bugün ortaya çıkardık. Zemberek projesinin .NET "port"u olan NZemberek'in 0.1 sürümü bugün itibariyle yayınlandı. 17 Kasım'dan sonra kodların .NET (C#) karşılıklarını oluşturduk. Bu iş, bazı araçları ya da otomatikleştirilmiş komutları kullanarak ne kadar hızla yapılsa da birçok zorlukla karşılaşılabiliyor. Zemberek ekibinin de desteğiyle şu anda Zemberek2 projesinin işlevlerini neredeyse tamamıyla yerine getiren bir sürüm mevcut.

linuxdevices.com : xynth windowing system

anhanguera

v0.7.90'ı çıkardıktan sonra download sayısını ve çeşitli haber sitelerini acaba bir hareket olur mu diye sürekli takip ederken (heyecan işte) bu akşam proje arkadaşım Ali Çaglar Oral, http://www.linuxdevices.com' daki Lightweight windowing system supports embedded Linux başlıklı haberi farketmiş, bana da haber verdi.