FAQ
Apa itu MABIMS?
MABIMS singkatan dari Menteri-menteri Agama Brunei, Indonesia, Malaysia, Singapura. Istilah ini lebih sering dipakai dalam konteks kriteria rukyah yang digunakan Kemenag RI untuk menentukan awal bulan Hijriah, khususnya awal Ramadhan, Syawal, dan Dzulhijjah. Kriteria Neo MABIMS mensyaratkan hilal terlihat minimal 3° dan elongasi minimal 6,4° saat matahari terbenam.
Kenapa tanggal Hijriah di aplikasi saya beda dengan yang diumumkan pemerintah Indonesia?
Kebanyakan API dan aplikasi kalender Hijriah memakai kriteria Umm al-Qura (Arab Saudi) sebagai default. Karena metode rukyah dan lokasi pengamatannya berbeda, hasilnya bisa selisih ±1 hari dari keputusan resmi Kemenag, terutama untuk awal puasa, Idulfitri, dan Idul Adha.
MABIMS vs Umm al-Qura, mana yang lebih akurat untuk Indonesia?
Untuk keperluan di Indonesia, MABIMS lebih akurat karena berdasarkan imkan rukyah, sehingga dapat diverifikasi Kemenag RI melalui sidang isbat. Umm al-Qura dirancang untuk kebutuhan Arab Saudi dan tidak merepresentasikan hasil rukyah Indonesia.
Apakah API ini produk resmi Kemenag atau MABIMS?
Bukan. API ini independen, dibangun menggunakan data tabel resmi Kemenag RI sebagai sumber. Untuk kepastian hukum syar’i, tetap rujuk pengumuman resmi Kemenag.
Akses & Autentikasi
Section titled “Akses & Autentikasi”Apakah API ini gratis dan butuh API key?
Ya, gratis dan tanpa autentikasi. Cukup panggil endpoint langsung, tanpa registrasi atau API key.
Apakah bisa dipakai langsung dari frontend (client-side)?
Bisa. CORS bersifat terbuka, jadi bisa dipanggil langsung dari browser di domain manapun. Untuk detail rate limit dan kebijakan penggunaan wajar, lihat halaman Access & Rate Limits.
Teknis
Section titled “Teknis”Apa bedanya source: "mabims" dan source: "mabims-computed"?
mabims— tanggal diambil langsung dari kalender resmi Kemenag.mabims-computed— dihitung otomatis dengan kriteria Neo MABIMS karena tanggal berada di luar cakupan tabel resmi.
Data-nya sampai tahun berapa?
Cek info data terbaru di halaman Data Coverage. Di luar rentang itu, API menghitung otomatis (fallback) memakai kriteria Neo MABIMS. Responsnya akan menandai source: "mabims-computed" dan bukan "mabims".
Zona waktu apa yang dipakai secara default?
Default-nya Asia/Jakarta (UTC+7), khusus untuk endpoint /today. Bisa di-override dengan parameter tz memakai zona IANA (mis. Asia/Kuala_Lumpur) atau UTC offset (mis. UTC+8). Endpoint /convert tidak bergantung timezone karena sifatnya konversi tanggal, bukan “hari ini”.
Bagaimana cara konversi tanggal Masehi ke Hijriah atau sebaliknya?
Pakai endpoint GET /convert?date=YYYY-MM-DD&calendar=gregorian atau calendar=hijri sesuai arah konversi yang diinginkan. Lihat dokumentasi lengkap: Referensi API /convert.
Bagaimana cara mengecek visibilitas hilal untuk bulan tertentu?
Gunakan endpoint /hilal/info untuk data kriteria, atau /hilal/viz untuk grafik visibilitas hilal (720×1280 PNG) yang menampilkan posisi bulan, arah sabit, dan verdict TERLIHAT/TIDAK TERLIHAT — dihitung di titik Sabang.
Lainnya
Section titled “Lainnya”Apakah API ini open source?
Ya, kode sumbernya terbuka di GitHub: PijarAdiluhung/mabims-api. Kontribusi dan laporan isu selalu diterima.
Siapa yang membuat mabims.dev?
mabims.dev dibuat oleh Pijar Sukma Adiluhung, developer asal Indonesia yang juga penghobi astronomi amatir (nggak heran kalau endpoint /hilal/viz digarap detail). Proyek ini lahir dari pengalaman pribadi melihat banyak aplikasi kalender Hijriah di Indonesia pakai kriteria Umm al-Qura yang kurang pas untuk konteks lokal. Kamu bisa lihat proyek lain buatannya di kajian.malangmengaji.com, atau cek kode sumber mabims.dev di GitHub. Bisa juga baca tulisannya di /blog.