İçeriğe geç

Kaynaklar

Geliştiriciler

Kur’an verileriyle geliştirme yapanlar için kaynaklar.

Kur’an derlemimiz

Kur’an metni, kelime kelime veriler, mealler, tefsirler, dipnotlar, arama ve ses meta verileri kendi veritabanımızdan qurangallery.com/quran/api/quran üzerinden sunulur. Okuma sayfasındaki hiçbir şey üçüncü taraf bir API’nin çalışıyor olmasına bağlı değildir.

Kur’an’ın tamamını altı yazı varyantında, 150 meal, 23 tefsir ve her kelime için mushaf bazında sayfa ve satır konumlarıyla kapsar — ayrıca sureler, ayetler, cüzler ve diğer bölümlerin meta verilerini de içerir. Yanıtlar, çoğu Kur’an aracının zaten beklediği v4 yanıt yapısını izler; böylece mevcut istemciler onları değişiklik yapmadan okur. Tilavet sesinin kendisi ise hâlâ QuranCDN’den akışla sunulur.

API başvurusu

Aşağıdaki her uç nokta kendi derlemimizden sunulur ve alışılmış v4 sorgu parametrelerini (language, translations, words, page) kabul eder.

Başlıca uç noktalar:

  • /chapters — 114 surenin tamamını meta verileriyle listeler
  • /verses/by_chapter/:id — Belirli bir surenin ayetlerini getirir
  • /search — Mealler içinde tam metin arama
  • /resources/recitations — Mevcut kâriler ve ses dosyaları
  • /resources/translations — Tüm dillerdeki mevcut mealler

Teknoloji Yığını

Quran Gallery, performans ve erişilebilirliğe odaklanan modern web teknolojileriyle geliştirilmiştir:

Ön yüz
Svelte 5 ile SvelteKit 2, Tailwind CSS v4
Çalışma ortamı
Kendi barındırdığımız bir VPS’te Node.js (adapter-node)
Veritabanı
Drizzle ORM üzerinden PostgreSQL
Uluslararasılaştırma
Paraglide JS — RTL dahil 7 dil

Açık Kaynak

Müslüman topluma hizmet eden projelerde açık iş birliğine inanıyoruz. Katkılar memnuniyetle karşılanır — hata düzeltmek, çevirileri iyileştirmek, özellik eklemek ya da erişilebilirliği artırmak olsun.

Mimari

Quran Gallery, her biri platformun farklı bir bölümüne hizmet eden Node.js servislerinden oluşan bir monorepo olarak çalışır. Caddy, istekleri yol önekine göre VPS üzerindeki ilgili servise yönlendirir.

qurangallery.com (Ağ geçidi)  /quran   → Kur’an okuyucu ve inceleme araçları  /chat    → Yapay zekâ destekli Kur’an sohbeti  /studio  → İslami sanat stüdyosu  /hifz    → Ezber takibi  /adhkar  → Günlük dualar  /blog    → Makaleler ve rehberler

İletişim

Teknik sorular, API sorunları ya da iş birliği talepleri için [email protected] adresine yazın veya GitHub’da bir kayıt (issue) açın.