FAL-013

API developer

API publik SIFASYA versi 1 untuk waktu, jadwal salat, kiblat, konversi Hijriah, pencarian wilayah, dan metadata. Semua respons memakai amplop JSON yang konsisten.

Dasar

Base URL: https://mail.sifasya.com/api/v1
Autentikasi: Tidak diperlukan (akses publik, dibatasi rate limit)
Format: JSON · header X-Request-ID
Versi engine: falak-core@1.0.0

Endpoint

Metode	Path	Keterangan	Parameter
GET	/api/v1/time	Waktu server dan status bukti sinkronisasi.	—
GET	/api/v1/prayer-times	Jadwal salat harian.	latitude, longitude, timezone, date, provider, administrative_area_id
GET	/api/v1/prayer-times/month	Jadwal salat sebulan.	latitude, longitude, timezone, year, month, provider
GET	/api/v1/qibla	Bearing dan jarak ke Ka’bah.	latitude, longitude
GET	/api/v1/hijri/convert	Konversi Masehi ke Hijriah dan sebaliknya.	date / hijri_year, hijri_month, hijri_day
GET	/api/v1/hijri/month	Satu bulan Hijriah.	hijri_year, hijri_month
GET	/api/v1/locations/search	Pencarian wilayah administratif.	q
GET	/api/v1/meta/features	Katalog fitur dan statusnya.	—
GET	/api/v1/meta/methods	Metadata metode perhitungan dan versi engine.	—

Amplop respons

{
  "ok": true,
  "data": { ... },
  "meta": {
    "generated_at": "2026-01-01T00:00:00+00:00",
    "request_id": "uuid",
    "data_status": "available"
  }
}

Respons gagal mengembalikan ok: false dengan objek error berisi code, message, dan request_id.

Catatan

Field meta.source_kind menandai asal data (official_published, computed, atau third_party). Data hasil perhitungan aplikasi bersifat edukatif dan dilabeli jelas; data resmi mengikuti sumber yang tercantum.