API Dokumentasi

← Kembali ke Laman Utama | Soalan Lazim

📌 Nota: Laman web ini menggunakan API daripada api.waktusolat.online untuk mendapatkan data waktu solat yang tepat dan terkini dari sumber rasmi JAKIM.

Tentang API

API ini menyediakan data waktu solat untuk seluruh Malaysia berdasarkan zon-zon solat yang ditetapkan oleh JAKIM. Semua endpoint adalah percuma dan tidak memerlukan authentication.

Base URL: https://api.waktusolat.online

Repository: github.com/shabilullah/gowaktusolat

Endpoints

1. Dapatkan Senarai Zon

GET /api/zones

Mendapatkan senarai semua zon solat di Malaysia.

Response:

[
  {
    "jakimCode": "SGR01",
    "negeri": "Selangor",
    "daerah": "Gombak, Petaling, Sepang, Hulu Langat, Hulu Selangor, Rawang, S.Alam"
  },
  ...
]

2. Waktu Solat Berdasarkan Zon

GET /api/solat/{zone}?month={month}&year={year}

Mendapatkan jadual waktu solat untuk zon tertentu.

Parameters:

Parameter	Type	Required	Description
`zone`	string	Yes	Kod zon JAKIM (contoh: SGR01, JHR01)
`month`	integer	No	Bulan (1-12). Default: bulan semasa
`year`	integer	No	Tahun. Default: tahun semasa

Contoh Request:

GET https://api.waktusolat.online/api/solat/SGR01?month=7&year=2026

Response:

{
  "zone": "SGR01",
  "prayerTime": [
    {
      "date": "01-Jul-2026",
      "fajr": "05:44:00",
      "syuruk": "06:58:00",
      "dhuhr": "13:08:00",
      "asr": "16:34:00",
      "maghrib": "19:15:00",
      "isha": "20:30:00"
    },
    ...
  ]
}

3. Waktu Solat Berdasarkan GPS

GET /api/solat/gps/{lat}/{long}?month={month}&year={year}

Mendapatkan waktu solat berdasarkan koordinat GPS. API akan mencari zon terdekat secara automatik.

Parameters:

Parameter	Type	Required	Description
`lat`	float	Yes	Latitude (contoh: 3.1390)
`long`	float	Yes	Longitude (contoh: 101.6869)
`month`	integer	No	Bulan (1-12)
`year`	integer	No	Tahun

Contoh Request:

GET https://api.waktusolat.online/api/solat/gps/3.1390/101.6869?month=7&year=2026

4. Maklumat Kemaskini Terakhir

GET /api/last-update

Mendapatkan maklumat bila data terakhir dikemaskini.

Response:

{
  "last_run": "2026-07-04 12:00:00"
}

5. Jadual PDF

GET /api/jadual_solat/{zone}?year={year}

Muat turun jadual waktu solat tahunan dalam format PDF.

Contoh:

GET https://api.waktusolat.online/api/jadual_solat/SGR01?year=2026

Kod Contoh

JavaScript / Fetch

// Dapatkan zon
fetch('https://api.waktusolat.online/api/zones')
  .then(res => res.json())
  .then(zones => console.log(zones));

// Dapatkan waktu solat
fetch('https://api.waktusolat.online/api/solat/SGR01?month=7&year=2026')
  .then(res => res.json())
  .then(data => console.log(data.prayerTime));

PHP / cURL

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.waktusolat.online/api/solat/SGR01");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Python / Requests

import requests

response = requests.get(
    'https://api.waktusolat.online/api/solat/SGR01',
    params={'month': 7, 'year': 2026}
)
data = response.json()
print(data['prayerTime'])

CORS

API ini menyokong Cross-Origin Resource Sharing (CORS) untuk semua origin. Anda boleh menggunakan API ini dari mana-mana domain.

Rate Limiting

Tiada had rate limiting buat masa ini. Sila gunakan API dengan berhemah.

Sumber Data

Semua data waktu solat diambil dari sumber rasmi JAKIM (Jabatan Kemajuan Islam Malaysia) dan dikemaskini secara berkala.

Sokongan

Untuk laporan bug atau cadangan peningkatan, sila buka issue di GitHub repository.