Digital Falak API

Referensi API Digital Falak

Tiga endpoint publik untuk waktu sholat, arah kiblat, dan kalender hijriah — hasil hisab yang sama persis dipakai aplikasi Digital Falak sendiri. JSON polos, tanpa API key.

Tanpa autentikasi Batas 30 permintaan/menit per IP CORS: semua origin diizinkan Geocoding: Nominatim/OSM
Base URL https://www.digitalfalak.com
GET /api.php

Waktu Sholat

Jadwal sholat harian (Imsak s/d Isya') dan lama bayangan kiblat, untuk satu titik koordinat dan tanggal Masehi.

ParameterKeterangan
tglwajibTanggal, 1–31
blnwajibBulan Masehi, 1–12
latwajibLintang, −90 s/d 90
lonwajibBujur, −180 s/d 180
tzwajibZona waktu, mis. 7 untuk WIB
standaropsionalWS (Waktu Setempat) atau WIS (Waktu Istiwak) — default WS
formatopsional12 atau 24 jam — default 24
tinggiopsionalTinggi tempat (meter) — default 0
ihtopsionalIhtiyat (menit pengaman) — default 3/60
isyaopsionalSudut Matahari Isya' — default 17.8°
shubuhopsionalSudut Matahari Shubuh — default 19.8°
Request
GET https://www.digitalfalak.com/api.php?tgl=10&bln=3&lat=-7.25&lon=112.75&tz=7
Response — 200 OK

        
      
GET /api/kiblat.php

Arah Kiblat

Azimuth kiblat dalam notasi derajat–menit–detik, diukur dari titik Utara sejati searah jarum jam.

ParameterKeterangan
latwajibLintang, −90 s/d 90
lonwajibBujur, −180 s/d 180
Request
GET https://www.digitalfalak.com/api/kiblat.php?lat=-7.25&lon=112.75
Response — 200 OK

        
      
GET /api/kalender.php

Kalender Hijriah

Konversi satu tanggal Masehi ke Hijriah. Tanpa parameter sama sekali, defaultnya hari ini di Pasuruan.

ParameterKeterangan
tgl, bln, thnopsionalTanggal Masehi — default hari ini
lat, lon, tzopsionalDefault Pasuruan (−7.6469, 112.8999, WIB)
Request
GET https://www.digitalfalak.com/api/kalender.php?tgl=17&bln=8&thn=2026
Response — 200 OK

        
      

Konvensi

Amplop respons

Selalu {"status", "data"} saat berhasil. Gagal → status:"error" + message penjelas, tanpa data.

Validasi parameter

Parameter wajib hilang atau di luar rentang → status:"error" beserta daftar field yang bermasalah dan contoh request yang benar.

Zona waktu

Semua jam pada respons memakai tz yang dikirim — API tidak menebak zona waktu dari koordinat.

Lintas origin

Header Access-Control-Allow-Origin: * terpasang di semua endpoint — aman dipanggil langsung dari fetch() di domain manapun.