API Jadwal Waktu Sholat & Imsyak Indonesia

API Jadwal Sholat Indonesia adalah layanan API yang menyediakan jadwal waktu sholat lengkap untuk seluruh kabupaten/kota di Indonesia. API ini mencakup 5 waktu sholat wajib (Shubuh, Dzuhur, Ashr, Maghrib, Isya) plus waktu tambahan (Imsyak, Terbit, Dhuha) yang penting untuk puasa Ramadan dan aktivitas ibadah lainnya. Data disediakan per kabupaten/kota dengan offset GMT, format JSON yang konsisten, dan pagination support. Layanan ini ideal untuk aplikasi Muslim, pengingat adzan, jadwal puasa, konten Ramadan, dan integrasi komunitas Islam.

Untuk menggunakan API ini, Anda perlu mendaftar dan mendapatkan API key terlebih dahulu di dashboard. Setelah mendapatkan API key, sertakan dalam header request sebagai x-api-co-id: YOUR_API_KEY. Gunakan endpoint /regional/indonesia/prayer-times/regencies untuk mendapatkan daftar kabupaten/kota yang tersedia, lalu gunakan endpoint utama dengan parameter regency_code (wajib) dan parameter opsional start_date, end_date untuk filter tanggal. Semua endpoint mengembalikan data dalam format JSON dengan pagination support (100 item per halaman).

API ini menyediakan 5 waktu sholat wajib (Shubuh, Dzuhur, Ashr, Maghrib, Isya), Imsyak (waktu dimulainya puasa/sahur), Dhuha (sholat dhuha), dan waktu Terbit (matahari terbit). Format waktu dalam HH:mm (24 jam). Data ini sangat berguna untuk aplikasi adzan, pengingat puasa, jadwal sahur dan buka puasa selama Ramadan, serta berbagai konten dan integrasi Islam lainnya.

Ya, API ini benar-benar gratis dengan 0 points per hit. Paket Standard memberikan 3.000 successful hits per bulan dan 20 request per detik tanpa biaya. Cocok untuk pengembangan, testing, aplikasi pribadi, dan aplikasi dengan volume rendah hingga menengah. Jika Anda membutuhkan lebih banyak hits atau rate limit lebih tinggi, tersedia paket Premium dengan hits tak terbatas, rate limit 100 req/s, dengan harga Rp 50.000 per bulan. Tidak ada biaya tersembunyi atau komitmen jangka panjang.

Data jadwal sholat yang disediakan adalah data resmi dan akurat untuk setiap kabupaten/kota di Indonesia. Perhitungan waktu sholat menggunakan koordinat geografis yang tepat untuk setiap wilayah, termasuk penyesuaian GMT (Greenwich Mean Time) offset yang sesuai. Setiap kabupaten/kota memiliki offset GMT yang berbeda (misalnya GMT+7 untuk WIB, GMT+8 untuk WITA, GMT+9 untuk WIT). Data diperbarui secara berkala untuk memastikan akurasi, terutama untuk perhitungan waktu yang dapat berubah karena pergerakan matahari sepanjang tahun.

Anda dapat memfilter jadwal sholat menggunakan parameter query opsional start_date dan end_date dengan format YYYY-MM-DD. Contoh: ?regency_code=3171&start_date=2024-01-01&end_date=2024-01-31 untuk mendapatkan jadwal sholat sepanjang bulan Januari 2024. Parameter regency_code wajib diisi (4 digit, contoh: 3171 untuk Jakarta Selatan). Data diurutkan berdasarkan tanggal secara ascending, dan hasilnya dipaginate dengan 100 item per halaman. Jika tidak menyertakan parameter tanggal, API akan mengembalikan semua data yang tersedia untuk kabupaten/kota tersebut.

GMT offset (Greenwich Mean Time offset) adalah perbedaan waktu antara zona waktu lokal dengan GMT. Setiap kabupaten/kota di Indonesia memiliki offset GMT yang berbeda: GMT+7 untuk WIB (Waktu Indonesia Barat), GMT+8 untuk WITA (Waktu Indonesia Tengah), dan GMT+9 untuk WIT (Waktu Indonesia Timur). Data GMT offset tersedia dalam response API, yang membantu Anda melakukan konversi waktu atau penyesuaian zona waktu dalam aplikasi. Informasi GMT sangat berguna untuk aplikasi yang perlu menampilkan waktu dalam berbagai zona waktu atau untuk sinkronisasi dengan sistem lain.

Ya, API ini sangat cocok untuk aplikasi jadwal puasa Ramadan. API menyediakan waktu Imsyak (dimulainya puasa/sahur) dan Maghrib (buka puasa) yang merupakan waktu kunci untuk puasa. Dengan data ini, Anda dapat membuat fitur pengingat sahur, pengingat buka puasa, jadwal puasa harian, konten Ramadan, atau integrasi dengan aplikasi komunitas Islam. Data jadwal sholat tersedia sepanjang tahun, sehingga Anda dapat mempersiapkan fitur Ramadan jauh sebelumnya atau menggunakannya untuk berbagai keperluan ibadah lainnya di luar bulan Ramadan.

Rate limit berbeda tergantung paket yang Anda gunakan: Paket Standard (Gratis) memiliki rate limit 20 request per detik, sementara Paket Premium memiliki rate limit 100 request per detik. Rate limit diterapkan untuk menjaga kualitas layanan untuk semua pengguna. Jika Anda melebihi rate limit, API akan mengembalikan response 429 Too Many Requests. Untuk aplikasi dengan volume tinggi, pertimbangkan untuk menggunakan paket Premium atau mengimplementasikan caching pada sisi aplikasi untuk mengurangi jumlah request yang diperlukan.

API ini menggunakan pagination dengan ukuran tetap 100 item per halaman. Untuk navigasi, gunakan parameter query page (opsional, default: 1). Setiap response yang mendukung pagination akan menyertakan object paging dengan informasi: page (halaman saat ini), size (jumlah item per halaman, selalu 100), total_item (total item), dan total_page (total halaman). Contoh: untuk mendapatkan halaman kedua, gunakan ?regency_code=3171&page=2. Pagination size tidak dapat dikonfigurasi dan tetap 100 item per halaman untuk konsistensi performa.

Semua endpoint mengembalikan response dalam format JSON dengan struktur konsisten: is_success (boolean), message (string), data (array atau object), dan paging (object dengan page, size, total_item, total_page) untuk endpoint yang mendukung pagination. Setiap item jadwal sholat berisi: id, regency_code, regency_name, gmt (offset GMT), date (YYYY-MM-DD), year, month, day, serta 5 waktu sholat wajib (shubuh, dzuhur, ashr, maghrib, isya), Imsyak, Dhuha, dan waktu Terbit dalam format HH:mm. Response selalu dalam format yang dapat diprediksi dan mudah diintegrasikan.

Data jadwal sholat diperbarui secara berkala untuk memastikan akurasi, terutama untuk mengakomodasi perubahan waktu sholat yang terjadi sepanjang tahun karena pergerakan matahari. Perhitungan waktu sholat bergantung pada posisi matahari yang berubah setiap hari, sehingga data perlu diperbarui secara rutin. Database kami selalu diperbarui untuk memastikan data yang Anda terima akurat dan sesuai dengan perhitungan resmi. Anda tidak perlu khawatir tentang sinkronisasi manual—API selalu menyediakan data terbaru yang siap digunakan.

Ya, API ini sangat cocok untuk aplikasi mobile (iOS, Android, atau aplikasi hybrid). API menggunakan format JSON standar yang mudah diparsing di berbagai platform, dan autentikasi sederhana menggunakan header x-api-co-id yang mudah diimplementasikan. Untuk aplikasi mobile, disarankan untuk mengimplementasikan caching lokal untuk mengurangi jumlah API call dan meningkatkan performa. Rate limit 20 req/s untuk Standard dan 100 req/s untuk Premium sudah cukup untuk kebanyakan aplikasi mobile. API ini telah digunakan oleh berbagai aplikasi mobile Islam dan pengingat adzan.

Jika Anda melebihi batas 3.000 successful hits per bulan pada paket Standard, API akan mengembalikan response error yang mengindikasikan bahwa Anda telah mencapai batas monthly limit. Untuk melanjutkan penggunaan, Anda memiliki beberapa opsi: 1) Upgrade ke paket Premium (Rp 50.000/bulan) untuk mendapatkan hits tak terbatas, 2) Menunggu hingga bulan berikutnya ketika quota direset, atau 3) Mengoptimalkan penggunaan dengan mengimplementasikan caching untuk mengurangi jumlah API call. Dashboard akan menampilkan informasi penggunaan quota Anda, sehingga Anda dapat memantau penggunaan dan merencanakan upgrade jika diperlukan.

Anda dapat upgrade kapan saja langsung dari dashboard. Paket Premium menawarkan hits tak terbatas, rate limit lebih tinggi (100 req/s), dengan harga tetap Rp 50.000 per bulan (sekitar $3,50). Proses upgrade sangat mudah dan tidak memerlukan perubahan kode—hanya perlu mengaktifkan paket Premium di dashboard dengan top up balance minimal 50.000 points. Setelah upgrade, semua limit akan langsung diperbarui dan Anda dapat menggunakan API tanpa batasan hits per bulan. Premium sangat direkomendasikan untuk aplikasi produksi dengan volume tinggi atau untuk pengembang yang membutuhkan rate limit lebih tinggi.