API Rehberi - Tertil

GET

/api/surasSurelerin listesini ve sistemdeki aktif mealleri döner.

GET

/api/sura/[id]Belirtilen surenin ayetlerini orijinal Arapça metni ve talep edilen mealleriyle birlikte getirir.

GET

/api/searchKur'an Arapça metninde veya meallerin içinde kelime araması yapar. Sonuçları sure/ayet bazında gruplar.

GET

/api/all-versesKur'an'daki 6.236 ayetin tamamını sure/ayet sırasıyla, sayfa/cüz bilgisi ve istenen meallerle tek yanıtta döner.

GET

/api/content-versionİçerik sürümünü döner. Kur'an metni, mealler veya sure isimleri her değiştiğinde artar; istemciler önbelleği yenilemek için kullanır.

GET

/api/settingsAna sayfanın görünüm ayarlarını döner (arama, meal başlıkları, meal seçici, yalnız Arapça).

GET

/api/mushaf/page/[page]Bir mushaf sayfasındaki ayetleri sayfa, cüz, hizb ve rub bilgisiyle döner.

GET

/api/mushaf/locateBir ayetin hangi mushaf sayfasında ve cüzde olduğunu döner.

GET

/api/mushaf/juz/[juz]Cüzün başladığı ilk mushaf sayfasını döner.

GET

/api/prayer/timesKoordinata göre bugünden başlayarak namaz vakitlerini hesaplar (adhan kütüphanesi). Saatler konumun saat diliminde HH:mm; timestamps alanı UTC ISO zamanları içerir.

GET

/api/prayer/searchOpenStreetMap Nominatim üzerinden konum arar (en fazla 5 sonuç).

GET

/api/admin/translationsSistemdeki tüm mealleri ve her bir meal için veritabanında çevrilmiş olan ayet sayısını listeler.

POST

/api/admin/translationsYeni bir meal versiyonu ekler ve bu meal için 6,236 ayet satırını otomatik olarak boş içerikle başlatır.

PUT

/api/admin/translations/[id]Mevcut bir mealin adını, dilini, mütercimini ve aktiflik durumunu günceller. Varsayılan meal pasif yapılamaz.

DELETE

/api/admin/translations/[id]Belirtilen meali ve bu meale ait veritabanındaki TÜM ayet çevirilerini geri döndürülemez biçimde siler. Varsayılan meal silinemez.

GET

/api/admin/versesYönetim panelinde düzenlemek üzere belirli bir surenin ayetlerini ve seçilen mealin çevirisini getirir.

PUT

/api/admin/versesSeçili mealdeki tek bir ayetin çeviri metnini günceller veya kaydeder.

POST

/api/admin/translations/[id]/defaultMeali varsayılan meal yapar. İstemciler meal belirtmediğinde bu meal döner. Pasif meal varsayılan yapılamaz.

PUT

/api/admin/arabic-versesBir ayetin Arapça metnini günceller. Arapça metin tüm meallerde ortaktır.

PUT

/api/admin/suras/[id]Surenin Türkçe, İngilizce ve Arapça adını günceller. Ayet sayısı değiştirilemez.

GET

/api/admin/settingsAna sayfa görünüm ayarlarını döner.

PUT

/api/admin/settingsAna sayfa görünüm ayarlarından bir veya birkaçını kaydeder. Boş bırakılan alanlar değişmez.

GET

/api/admin/summaryVeritabanı özeti: meal sayıları, varsayılan meal, içerik sürümü ve mushaf metadata sayıları.

← Siteye Dön

🛠 Yönetici Paneli