Lewati ke konten

Sumber daya

Pengembang

Sumber daya bagi pengembang yang membangun dengan data Al-Qur’an.

Korpus Al-Qur’an kami

Teks Al-Qur’an, data kata per kata, terjemahan, tafsir, catatan kaki, pencarian, dan metadata audio disajikan dari basis data kami sendiri melalui qurangallery.com/quran/api/quran. Tidak ada bagian halaman baca yang bergantung pada tersedianya API pihak ketiga.

Korpus ini mencakup Al-Qur’an lengkap dalam enam varian tulisan, 150 terjemahan, 23 tafsir, serta posisi halaman dan baris per mushaf untuk setiap kata — ditambah metadata surah, ayat, juz, dan pembagian lainnya. Respons mengikuti bentuk respons v4 yang sudah diharapkan sebagian besar perangkat Al-Qur’an, sehingga klien yang ada dapat membacanya tanpa perubahan. Audio tilawah sendiri masih dialirkan dari QuranCDN.

Referensi API

Setiap endpoint di bawah ini disajikan dari korpus kami sendiri dan menerima parameter kueri v4 yang biasa (language, translations, words, page).

Endpoint utama meliputi:

  • /chapters — Daftar ke-114 surah beserta metadatanya
  • /verses/by_chapter/:id — Ambil ayat-ayat untuk surah tertentu
  • /search — Pencarian teks lengkap di seluruh terjemahan
  • /resources/recitations — Qari dan berkas audio yang tersedia
  • /resources/translations — Terjemahan yang tersedia dalam semua bahasa

Teknologi

Quran Gallery dibangun dengan teknologi web modern yang berfokus pada kinerja dan aksesibilitas:

Frontend
SvelteKit 2 dengan Svelte 5, Tailwind CSS v4
Runtime
Node.js di VPS yang dikelola sendiri (adapter-node)
Basis data
PostgreSQL melalui Drizzle ORM
Internasionalisasi
Paraglide JS — 7 bahasa termasuk RTL

Sumber Terbuka

Kami meyakini kolaborasi terbuka untuk proyek-proyek yang melayani umat Muslim. Kontribusi sangat kami sambut — baik memperbaiki galat, menyempurnakan terjemahan, menambah fitur, maupun meningkatkan aksesibilitas.

Arsitektur

Quran Gallery berjalan sebagai monorepo layanan Node.js, masing-masing melayani bagian platform yang berbeda. Caddy merutekan permintaan berdasarkan awalan jalur ke layanan yang sesuai di VPS.

qurangallery.com (Gateway)  /quran   → Pembaca Al-Qur’an dan alat belajar  /chat    → Obrolan Al-Qur’an berbasis AI  /studio  → Studio seni Islami  /hifz    → Pelacak hafalan  /adhkar  → Doa harian  /blog    → Artikel dan panduan

Kontak

Untuk pertanyaan teknis, masalah API, atau tawaran kolaborasi, hubungi [email protected] atau buka issue di GitHub.