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

İş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.

Javacılar İşleri Neden Zorlaştırıyor? (Ya da Perl, Haskell ve Lisp Üstüne)

FZ

Değerli FM üyelerinden ve editörlerinden Recai Oktaş ile programlama dilleri üzerine yazışırken bazı enteresan yazılarla karşılaştım. Konu dillerin bir araç olarak kullanımından bir kültür olarak nasıl bir bakış açısı sunduklarına geldi.

Söz gelimi 5 yılı aşkın süredir Java kodlayan, Java ile ilgili 2 kitabı bulunan ve Jakarta Struts projesinde aktif katılımcı olan James Turner'ın Why Do Java Developers Like to Make Things So Hard? başlıklı yazısı ilk paragraftaki duruma güzel bir örnek teşkil ediyordu. Turner kendince basit olan bir işi, FTP ile dosya yollamayı şifreli hale getirme işini Java ile yapmaya çalışmış ve ciddi bir karmaşa ile karşılaşmıştı. Aynı işi daha az deneyimli olduğu Perl ile yapmaya kalktığında ise...

typo3okulu.com

anonim

Typo3'yi Türk kullanıcılarına tanıtmak ve kullanmalarına yardımcı olmak amacıyla typo3okulu.com sitesi açıldı.

Windows'tan Linux'a Geçiş: OpenMoveOver

Soulblighter

Resolvo Systems Windows'tan Linux'a geçiş aracı MoveOver'ın ücretsiz ve açık kaynak sürümünü çıkardı. OpenMoveOver ile Windows oramınızı Linux'a taşımak geçiş yapmak sadece 2 basit adımda gerçekleştiriliyor.

Moveabletype ile kişisel web sitesi yönetimi

angeleous

Kişisel web sitenizde günlük olarak yaşadığınız olayları, paylaşmak istediklerinizi insanlara duyurmak, insanların yazdıklarınıza yorumlarını eklemelerine olanak sağlamak istiyorsanız movabletype bu iş için sade ve güçlü bir uygulama. Perl ile yazılmış uygulama MySQL, PostgreSQL, Berkeley DB destekliyor ileride de Oracle desteği verileceği belirtiliyor. Uygulamanın tüm özellikleri için buraya tıklayabilirsiniz.