Lewati ke konten

Quickstart

Base URL:

https://api.mabims.dev/api/v1

Kasus penggunaan yang paling umum: berapa tanggal Hijriah hari ini?

Terminal window
curl "https://api.mabims.dev/api/v1/today"
{
"input": { "date": "2026-08-24", "calendar": "gregorian", "tz": "Asia/Jakarta" },
"output": { "date": "1448-03-11", "calendar": "hijri", "day": 11, "month": 3, "month_name": "Rabiul Akhir", "year": 1448 },
"source": "mabims",
"warnings": []
}

today secara default menggunakan Asia/Jakarta (UTC+7). Anda bisa override dengan zona IANA atau UTC offset apa pun:

Terminal window
curl "https://api.mabims.dev/api/v1/today?tz=Asia/Kuala_Lumpur"
curl "https://api.mabims.dev/api/v1/today?tz=UTC+8"
Terminal window
curl "https://api.mabims.dev/api/v1/convert?date=2025-01-03&calendar=gregorian"
curl "https://api.mabims.dev/api/v1/convert?date=1446-07-03&calendar=hijri"

Setiap respons membawa field source:

  • mabims — dari sumber resmi Kemenag
  • mabims-computed — dihitung dengan kriteria Neo MABIMS

Perlakukan warnings sebagai pemberitahuan kepada pengguna apabila ia mengandung payload (tidak kosong).

API ini bersifat publik dan CORS-nya fleksibel, aplikasi client-side di domain mana pun dapat memanggilnya secara langsung. Panggilan server-side juga tidak dibatasi. Lihat Akses & Batas Rate untuk kebijakan lengkap dan detail perlindungan penyalahgunaan.