jadwal-sholat

从 API穆斯林 api.myquran.com（伊斯兰教宗教指导部来源）下载印度尼西亚城市/地区的祈祷时间表（imsak、黎明、中午、晡礼、昏礼、伊西亚）。当用户询问某个地点今天/某个日期/1个月的祈祷时间表，或者需要查找地区/城市ID时，可以使用它。

## 概述（中文）

从 API穆斯林 api.myquran.com（伊斯兰教宗教指导部来源）下载印度尼西亚城市/地区的祈祷时间表（imsak、黎明、中午、晡礼、昏礼、伊西亚）。当用户询问某个地点今天/某个日期/1个月的祈祷时间表，或者需要查找地区/城市ID时，可以使用它。

## 原文

# Jadwal Sholat (api.myquran.com)

API base: `https://api.myquran.com/v3`

Script helper (rekomendasi): `scripts/myquran_sholat.py`

## Quick start

Cari lokasi (kab/kota):

```bash
python3 scripts/myquran_sholat.py cari "tangerang"
```

Jadwal sholat hari ini (Asia/Jakarta) untuk lokasi berdasarkan keyword:

```bash
python3 scripts/myquran_sholat.py hari-ini "kota tangerang"
```

Jadwal sholat tanggal tertentu (format `YYYY-MM-DD`):

```bash
python3 scripts/myquran_sholat.py tanggal "kota tangerang" 2026-02-03
```

Jadwal sholat 1 bulan (format `YYYY-MM`):

```bash
python3 scripts/myquran_sholat.py bulan "kota tangerang" 2026-02
```

## Catatan pemilihan lokasi

Endpoint pencarian mengembalikan beberapa kandidat. Script akan:
- mencoba match exact (case-insensitive) ke kolom `lokasi` bila memungkinkan
- kalau tidak, pakai hasil pertama

Kalau hasilnya kurang tepat, gunakan keyword yang lebih spesifik (mis. `KOTA TANGERANG` vs `TANGERANG`), atau ambil `id` lokasi lalu panggil mode `id`.

## Pemanggilan langsung via curl (tanpa script)

Cari kab/kota:

```bash
curl -s "https://api.myquran.com/v3/sholat/kabkota/cari/tangerang"
```

Ambil jadwal hari ini:

```bash
curl -s "https://api.myquran.com/v3/sholat/jadwal/<ID>/today?tz=Asia/Jakarta"
```

Ambil jadwal periode (bulanan / harian):

```bash
# bulanan
curl -s "https://api.myquran.com/v3/sholat/jadwal/<ID>/2026-02?tz=Asia/Jakarta"

# harian
curl -s "https://api.myquran.com/v3/sholat/jadwal/<ID>/2026-02-03?tz=Asia/Jakarta"
```