TDK service, Türkçe sözlük
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
helpers
.editorconfig
.gitignore
LICENSE
README.md
config.js
constants.js
handler.js
package.json
serverless.yml

README.md

TDK Service

Türk Dil Kurumu'nun resmi sitesi üzerinden belirli standartlara göre veri getirebilen bir servis.

Açıklama 

Çevrimdışı bir Türkçe sözlük yapmak istiyordum. TDK'nın sitesinde bir REST API yapısı bulunmadığı için herşeyi kendimin yazması gerektiğini düşündüm.

Nodejs ile TDK'nın sitesinden verileri çekerek ona göre işlem yapan bir servis bulamadım. Ve bu konuda yardım edebilecek topluluk çok olduğu için Nodejs'i seçtim.

Geçici istek adresi

Geçici olmasının sebebi sistem oturana kadar kullanılabilir. Canlıya geçildiğinde bu adres kapanabilir. Bu adres kalıcı değildir.

https://nnv7qx39h3.execute-api.us-east-1.amazonaws.com/dev/getWord/?word=KELIME

KELIME yazan yere getirmek istediğiniz kelimeyi yazarak kelime detaylarını getirebilirsiniz.

Kurulum

Bir AWS hesabına sahip olmalısınız. Tüm ayarları serverless.yml dosyası üzerinde mevcut. Serverless Framework ile kurulum yapabilirsiniz. AWS'ye yayınlamak için (deploy):

serverless deploy -s dev

Amaç

AWS lambda kullanılarak yapılmış bu servis ile TDK üzerinde bulunan tüm özellikler servis haline getirilebilir. Ve gerçekten de kullanışlı bir sözlük olur. Şayet bu konuda (API konusunda) TDK'nın sitesi oldukça geride kalmış durumda. TDK dışında API yapılanmaları da mevcut fakat asıl güvenilecek resmi kaynak TDK olduğu için TDK'nın (eski de olsa) sitesini kullanmak durumundayız.

Yapısı

Bu servis üzerine yapılan çağrıları ilk önce DynamoDB NoSql veritabanında kontrol ederek oradaki verileri dönüyor. Eğer veritabanında veri yok ise bu durumda TDK'nın sitesine istek atarak oradan getirdiği veriler ile yeni bir kayıt işlemi yapıyor.

AWS Lambda

Bilindiği üzere aws lambda ile 5 dakikayı geçmeyecek şekilde fonksiyonlar çalıştırabiliyoruz. Bu proje tam da lambda'ya göre.

getWord methodu

handler.js üzerinde lambda'nın tetikleneceği methodlar vardır. Bunlardan biri de getWord. Bu method ile TDK üzerinde bulunan tüm kelimeler detaylı bir şekilde getirilebilir.

Örnek istek:

https://.../getWord?word=kardeş

Cevap:

[{
    "pronunciation": "kardeş",
    "slang": false,
    "old": false,
    "etymon": null,
    "name": "kardeş",
    "casual_speech": false,
    "type": "isim",
    "descriptions": [{
        "types": ["isim"],
        "say": "Öz kardeş. Üvey kardeş. Kız kardeş. Erkek kardeş.",
        "title": "Aynı anne babadan doğmuş veya anne babalarından biri aynı olan çocukların birbirine göre adı",
        "author": null
    }, {
        "types": null,
        "say": null,
        "title": "Yaşça küçük olan çocuk",
        "author": null
    }, {
        "types": ["ünlem"],
        "say": null,
        "title": "Adı bilinmeyen kimselere söylenen bir seslenme sözü",
        "author": null
    }, {
        "types": null,
        "say": "Din kardeşi. Yol kardeşi.",
        "title": "Aralarında değer verilen ortak bir bağ bulunanlardan her biri",
        "author": null
    }],
    "colloquialism": false,
    "tags": []
}]

Ana Değerler

Anahtar Anlamı
pronunciation okunuş
slang argo ise true değilse false
old eskimiş
etymon kelimenin kökeni ör: {name: "İngilizce",description: "test"} kelime kökeni yoksa Türkçe'dir
name kelimenin kendisi
casual_speech gündelik konuşma, teklifsiz konuşmada
type kelime türü (isim, sıfat vb.)
descriptions kelimeyle ilgili anlamlar

Açıklama (descriptions)

Anahtar Anlamı
types açıklamanın tüm türleri
say açıklamanın hakkında söylem
title açıklamanın kendisi
author say değerinde yazan betiği söyleyen kişi

Katkı

API tarafında yeterli olmadığını düşündüğüm yerler var mesela veriler güncellenmiyor ve güncellenme tarihleri kaydedilmiyor. TDK kelime sayfasından getirilen kelime tam anlamıyla modellenmedi. Örneğin o kelime ile ilgili deyimler kaydedilmiyor.

Eklenebilecek diğer özellikler

  • Atasözleri ve Deyimler Sözlüğü
  • Bilim ve Sanat Terimleri
  • Kişi Adları Sözlüğü
  • Yazım Kuralları