jadwal-sholat
# 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"
```
标签
skill
ai