Lewati ke konten

API jadwal sholat gratis, tanpa kunci API

API jadwal sholat gratis tanpa kunci atau pendaftaran. Waktu harian sebagai JSON lewat lintang dan bujur, plus feed iCal, pencarian kota, masjid terdekat.

Di halaman ini

API jadwal sholat di qurangallery.com/prayer/developers gratis dan tidak memerlukan kunci API atau pendaftaran. Empat endpoint publik mengembalikan jadwal sholat harian sebagai JSON untuk sebuah lintang dan bujur, feed iCal yang bisa dilanggani, pencarian kota, dan masjid terdekat.

Semua endpoint berada di bawah https://qurangallery.com/prayer. Input yang salah mengembalikan 400 dan terlalu banyak permintaan mengembalikan 429.

Jadwal sholat untuk sebuah lokasi

GET /api/times mengembalikan Subuh, terbit, Dzuhur, Ashar, Maghrib, dan Isya hari ini untuk sepasang koordinat, plus Subuh besok. Setiap waktu adalah instan ISO 8601 dalam UTC. Waktu yang tidak ada pada lintang itu di hari itu dilewatkan.

curl 'https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262'

Parameter:

  • lat — wajib. Lintang dalam derajat desimal.
  • lng — wajib. Bujur dalam derajat desimal.
  • method — opsional. ID metode perhitungan, misalnya mwl, isna atau karachi. Bawaan: metode kota terdekat.
  • asr — opsional. standard atau hanafi, yang menentukan waktu Ashar. Bawaan: kebiasaan umum di negara kota terdekat.
  • hlr — opsional. Aturan lintang tinggi: auto, middle-of-the-night, seventh-of-the-night atau twilight-angle. Bawaan: auto.
  • fa dan ia — opsional. Sudut Subuh dan Isya khusus dalam derajat, dari 10 sampai 25. Bawaan: sudut bawaan metodenya.

Responsnya, diringkas:

{
  "date": "2026-10-31",
  "times": [
    { "name": "fajr", "time": "2026-10-31T02:06:00.000Z", "isCurrent": false, "isNext": true },
    { "name": "sunrise", "time": "2026-10-31T03:23:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "dhuhr", "time": "2026-10-31T09:04:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "asr", "time": "2026-10-31T12:20:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "maghrib", "time": "2026-10-31T14:45:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "isha", "time": "2026-10-31T16:15:00.000Z", "isCurrent": false, "isNext": false }
  ],
  "fajrTomorrow": "2026-11-01T02:06:00.000Z"
}

Tanggalnya adalah hari lokal koordinat itu sendiri. Jadwal sholat tidak dibatasi secara terpisah, jadi simpan jawaban tiap lokasi untuk satu hari alih-alih memanggilnya di setiap tampilan halaman.

Pencarian kota

GET /api/location/search mengubah nama tempat menjadi koordinat, kode negara, dan zona waktu. Pencarian dimulai dari daftar kota milik aplikasi sendiri, dan kueri tanpa hasil mengembalikan array kosong.

curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'
  • q — wajib. Nama tempat, maksimal 200 karakter.
[
  {
    "lat": 21.4266,
    "lon": 39.8256,
    "displayName": "Makkah, Saudi Arabia",
    "countryCode": "SA",
    "timezone": "Asia/Riyadh"
  }
]

Ambil lat dan lon dari hasil pertama, lalu berikan sebagai lat dan lng ke endpoint jadwal sholat.

Feed kalender (iCal)

GET /api/calendar/feed.ics mengembalikan berkas text/calendar yang bisa dilanggani, berisi waktu sholat dan hari besar Islam, sebulan secara bawaan dan hingga 12 bulan. Tambahkan URL-nya sebagai langganan kalender di Google Calendar, Apple Calendar, atau Outlook.

curl 'https://qurangallery.com/prayer/api/calendar/feed.ics?lat=21.4225&lng=39.8262'

Wajib: lat dan lng. Opsional: method, asr, hlr, fa, ia seperti di atas, ditambah:

  • authority — otoritas kalender Hijriah untuk acara, misalnya umm_al_qura atau diyanet. Bawaan: otoritas negara kota terdekat.
  • months — jumlah bulan yang dicakup feed, dari 1 sampai 12. Bawaan: 1.
  • alarm — menit sebelum tiap sholat untuk pengingat, dari 0 sampai 120. 0 berarti tanpa alarm. Bawaan: 10.
  • sunrise, travel, ramadan, jumuah, busy — isi 1 untuk menyalakan waktu terbit, catatan perjalanan, acara Ramadan, Jumat pada hari Jumat, atau waktu sibuk. Bawaan: mati.

Anda juga bisa membuat feed yang sama tanpa kode di halaman sinkronisasi kalender. Feed kalender membolehkan 30 permintaan per menit.

Masjid terdekat

GET /api/mosques/nearby mendaftar masjid di sekitar sebuah titik, dari yang terdekat, berdasarkan data OpenStreetMap. Jaraknya dalam meter. Jawabannya 503 bila layanan data peta tidak tersedia.

curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'
  • lat dan lng — wajib.
  • radius — opsional. Radius pencarian dalam meter, dari 100 sampai 50000. Bawaan: 2000.
[
  {
    "id": 1234567,
    "name": "Example Mosque",
    "lat": 21.4231,
    "lng": 39.8269,
    "address": "Example Street 12",
    "distance": 96.4
  }
]

Cakupannya bergantung pada OpenStreetMap. Tampilan data yang sama di dalam aplikasi dijelaskan di halaman masjid.

Batas permintaan

Batas menghitung permintaan per alamat IP dalam jendela satu menit. Setelah melewati batas, Anda mendapat HTTP 429.

  • Jadwal sholat: tidak ada batas tersendiri.
  • Feed kalender: 30 permintaan per menit.
  • Pencarian kota dan masjid terdekat berbagi satu jatah: 30 permintaan per menit.

Memakainya dari peramban

API tidak mengirim header CORS, jadi halaman di situs lain tidak dapat membaca responsnya. Panggil dari server Anda. Jika Anda hanya ingin menampilkan jadwal di sebuah situs, pakai widget situs web: satu iframe, tanpa kode dan tanpa kunci.

Lihat juga

Langkah berikutnya

Pertanyaan

Apakah API jadwal sholat ini gratis, dan perlukah kunci API?

Ya, gratis dan tidak perlu kunci, akun, atau pendaftaran. Kirim permintaan GET ke endpoint dengan parameternya, dan patuhi batas permintaan.

Bagaimana cara mendapat jadwal sholat dari nama kota?

Panggil endpoint pencarian kota dengan q, ambil lat dan lon dari hasil pertama, lalu berikan sebagai lat dan lng ke endpoint jadwal sholat.

Metode perhitungan dan aturan Ashar apa yang dipakai API secara bawaan?

Tanpa method, API memakai metode kota yang paling dekat dengan koordinat Anda. Tanpa asr, API memakai kebiasaan Ashar yang lazim di negara kota itu. Kirim keduanya untuk menetapkannya.

Mengapa ada sholat yang hilang dari respons?

Di dekat kutub, matahari bisa tidak pernah mencapai sudut Subuh atau Isya, sehingga tidak ada waktu yang bisa diberikan. API melewatkan sholat itu alih-alih mengembalikan tanggal yang tidak valid.

Bisakah saya memanggil API dari JavaScript di peramban?

API tidak mengirim header CORS, jadi halaman di situs lain tidak dapat membaca responsnya. Panggil dari server Anda, atau pakai widget yang bisa disematkan, yang tidak memerlukan kode.

Apa saja batas permintaannya?

Batas menghitung permintaan per alamat IP dalam jendela satu menit. Feed kalender membolehkan 30 permintaan per menit, dan pencarian kota serta masjid terdekat berbagi satu jatah 30 per menit. Setelah melewati batas, Anda mendapat HTTP 429.

Seberapa sering saya perlu meminta jadwal sholat?

Sekali per lokasi per hari sudah cukup. Simpan responsnya dan hitung hitung mundur sendiri; Subuh besok disertakan untuk jam-jam setelah Isya.

Adakah feed iCal?

Ada. Feed kalender mengembalikan berkas .ics yang bisa dilanggani berisi waktu sholat dan hari besar Islam, sebulan secara bawaan dan hingga 12 bulan dengan parameter months.

Edit halaman ini di GitHub