Lugatify Logo

Lugatify API Sənədləri

Azərbaycan dili lüğət API-si üçün rəsmi sənədlər

Ümumi Baxış

Lugatify API, Azərbaycan dilində sözlərin mənasını, sinonimləri, antonimləri və digər məlumatlarını əldə etmək üçün istifadə olunan RESTful API-dir. Bu API ilə tətbiqlərinizə Azərbaycan dili lüğət funksiyalarını əlavə edə bilərsiniz.

Əsas URL

https://lugatifyapi.vercel.app

Autentifikasiya

Bütün API sorğuları üçün API açarı tələb olunur. API açarınızı sorğu parametri kimi təqdim etməlisiniz:

?key=sizin_api_açarınız

API açarı necə əldə etmək olar?

API açarı əldə etmək üçün Lugatify hesabına sahib olmalısınız. Hesab yaratdıqdan sonra, dashboard-dan API açarınızı görüntüləyə və idarə edə bilərsiniz.

Daxil ol

Endpoint: /checkword

Bu endpoint, verilən sözün lüğətdə olub-olmadığını yoxlayır və varsa söz haqqında ətraflı məlumat qaytarır.

HTTP Sorğusu

GET /checkword?word=kitab&key=sizin_api_açarınız

Parametrlər

word
Yoxlanılacaq söz (məcburi)
key
API açarı (məcburi)

Uğurlu Cavab

{
  "word": "kitab",
  "movcuddur": true,
  "izah": "Vərəqlərdən ibarət, cildlənmiş çap əsəri",
  "sinonimler": ["əsər", "nəşr"],
  "antonimler": [],
  "basqa_menalar": ["Elm, bilik mənbəyi"],
  "nitq_hissesi": "isim",
  "numune_cumle": "Kitabxanadan bir kitab götürdüm."
}

JavaScript Nümunəsi

Aşağıda JavaScript istifadə edərək API-yə necə sorğu göndərə biləcəyinizi göstərən bir nümunə var:

// Söz yoxlama
const checkWord = async (word, apiKey) => {
  try {
    const response = await fetch(
      `https://lugatifyapi.vercel.app/checkword?word=${encodeURIComponent(word)}&key=${apiKey}`
    );
    const data = await response.json();

    if (response.ok) {
      console.log(data);
      return data;
    } else {
      console.error(data.error);
      throw new Error(data.error);
    }
  } catch (error) {
    console.error("API sorğusu zamanı xəta:", error);
    throw error;
  }
};

// Təsadüfi söz
const getRandomWord = async (apiKey, options = {}) => {
  try {
    let url = `https://lugatifyapi.vercel.app/random?key=${apiKey}`;
    
    if (options.length) {
      url += `&length=${options.length}`;
    }
    
    if (options.nitq_hissesi) {
      url += `&nitq_hissesi=${encodeURIComponent(options.nitq_hissesi)}`;
    }
    
    const response = await fetch(url);
    const data = await response.json();
    
    if (response.ok) {
      console.log(data);
      return data;
    } else {
      console.error(data.error);
      throw new Error(data.error);
    }
  } catch (error) {
    console.error("API sorğusu zamanı xəta:", error);
    throw error;
  }
};

// İstifadə
const apiKey = "sizin_api_açarınız";

// Söz yoxlama nümunəsi
checkWord("kitab", apiKey)
  .then(result => {
    if (result.movcuddur) {
      console.log(`Söz: ${result.word}`);
      console.log(`İzah: ${result.izah}`);
    } else {
      console.log("Söz tapılmadı");
    }
  })
  .catch(error => {
    console.error("Xəta:", error.message);
  });

Python Nümunəsi

Aşağıda Python istifadə edərək API-yə necə sorğu göndərə biləcəyinizi göstərən bir nümunə var:

import requests

# API açarı
api_key = "sizin_api_açarınız"

# Söz yoxlama
def check_word(word):
    url = f"https://lugatifyapi.vercel.app/checkword"
    params = {
        "word": word,
        "key": api_key
    }
    
    response = requests.get(url, params=params)
    
    if response.status_code == 200:
        return response.json()
    else:
        return {"error": response.json().get("error", "Naməlum xəta")}

# Təsadüfi söz
def get_random_word(nitq_hissesi=None, length=None):
    url = f"https://lugatifyapi.vercel.app/random"
    params = {
        "key": api_key
    }
    
    if nitq_hissesi:
        params["nitq_hissesi"] = nitq_hissesi
        
    if length:
        params["length"] = length
    
    response = requests.get(url, params=params)
    
    if response.status_code == 200:
        return response.json()
    else:
        return {"error": response.json().get("error", "Naməlum xəta")}

# İstifadə
try:
    # Söz yoxlama nümunəsi
    result = check_word("kitab")
    if result.get("movcuddur", False):
        print(f"Söz: {result['word']}")
        print(f"İzah: {result['izah']}")
    else:
        print("Söz tapılmadı")
        
    # Təsadüfi söz nümunəsi
    random_word = get_random_word(nitq_hissesi="isim")
    print(f"Təsadüfi söz: {random_word['word']}")
    print(f"İzah: {random_word['izah']}")
    
except Exception as e:
    print(f"Xəta: {str(e)}")