Əsas Səhifə Mənə kofe al

YOX API Sənədləşdirmə

YOX API Azərbaycan tərzində mədəni "yox" bəhanələri təmin edir. Bu API-dən istifadə etmək çox asandır. Aşağıda API-nin istifadə qaydaları, parametrləri və nümunələr verilmişdir.

API Əsas URL

Bütün sorğular üçün əsas URL:

https://yox-as-a-service.onrender.com/

Endpoints

Bəhanə əldə etmək üçün istifadə olunan əsas endpoint kateqoriya adıdır:

GET /<kateqoriya_adı>

Məsələn:

GET /general
GET /sevgi_yeni

Parametrlər

`ad` (optional)

Bəhanənin içərisinə daxil ediləcək ad. Əgər təmin olunarsa, bəhanə bu adla fərdiləşdirilə bilər.

GET /general?ad=Elvin

Nümunə Cavab:

{
  "cavab": "Elvin, təəssüf ki, bu gün mümkün deyil. Başqa bir vaxt inşallah."
}

Cavab Formatı

Bütün cavablar JSON formatında qaytarılır.

{
  "cavab": "Bəhanə mətni burada olacaq."
}

Xəta baş verdikdə cavab formatı:

{
  "xeta": "Xəta mesajı burada olacaq."
}

Nümunələr

Curl ilə Ümumi Bəhanə

curl "https://yox-as-a-service.onrender.com/general"

Nümunə Cavab:

{
  "cavab": "Bağışlayın, işim çıxdı."
}

Curl ilə Adlı Sevgi Bəhanəsi

curl "https://yox-as-a-service.onrender.com/sevgi?ad=Ayşən"

Nümunə Cavab:

{
  "cavab": "Ayşən, qismət deyilmiş, alınmadı."
}

JavaScript ilə Bəhanə Əldə Etmə

const getName = "Orxan";
const getCategory = "is";

fetch(`https://yox-as-a-service.onrender.com/${getCategory}?ad=${encodeURIComponent(getName)}`)
  .then(response => response.json())
  .then(data => {
    document.getElementById('result-text').textContent = data.cavab;
  })
  .catch(error => {
    console.error('Xəta:', error);
    document.getElementById('result-text').textContent = 'Bəhanə əldə edilmədi.';
  });

Mövcud Kateqoriyalar

Aşağıdakı kateqoriyalar mövcuddur:

  • general (Ümumi)
  • sevgi (Sevgi)
  • dost (Dostluq)
  • muellim (Müəllim)
  • valideyn (Valideyn)
  • is (İş)
  • toy_yox (Toy)
  • qonaqliq_yox (Qonaqlıq)
  • yol_yox (Yol)
  • sosial_media_yox (Sosial Media)
  • oyun_yox (Oyun)
  • texnologiya_yox (Texnologiya)
  • pul_yox (Pul)
  • saglamliq_yox (Sağlamlıq)
  • qonsu_yox (Qonşu)
  • burokratiya_yox (Bürokratiya)
  • ev_isleri_yox (Ev İşləri)
  • felsefi_yox (Fəlsəfi)
  • hava_yox (Hava)
  • paltar_yox (Paltar)
  • general_yeni (Ümumi - Yeni)
  • ...və digər "Yeni" və "Xüsusi" kateqoriyalar.

Qeyd: Backend serverimiz pulsuz Render planında yerləşdiyi üçün API cavablarının gəlməsində gecikmələr ola bilər. Anlayışınız və səbriniz üçün təşəkkür edirik!