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!