jadwal-sholat

从 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"
```

---

## 中文说明

# Jadwal Sholat (api.myquran.com)

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

脚本辅助工具（推荐）：`scripts/myquran_sholat.py`

## 快速上手

查找地点（县/市）：

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

根据关键词查询某地点今天（Asia/Jakarta）的祈祷时间表：

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

查询特定日期的祈祷时间表（格式 `YYYY-MM-DD`）：

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

查询 1 个月的祈祷时间表（格式 `YYYY-MM`）：

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

## 关于地点选择的说明

搜索端点会返回多个候选项。脚本将：
- 在可能的情况下，尝试与 `lokasi` 列进行精确匹配（不区分大小写）
- 如果不能，则使用第一个结果

如果结果不够准确，请使用更具体的关键词（例如 `KOTA TANGERANG` 而非 `TANGERANG`），或者获取地点的 `id` 然后调用 `id` 模式。

## 通过 curl 直接调用（不使用脚本）

查找县/市：

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

获取今天的时间表：

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

获取某时段（每月/每日）的时间表：

```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"
```