Prayer Times API

GET /v1/prayer-times/:province

Lấy giờ cầu nguyện cho một tỉnh thành cụ thể.

Parameters

Tên	Loại	Bắt buộc	Mô tả
`province`	string	✓	Mã tỉnh thành (xem danh sách)
`date`	string	—	Ngày theo định dạng `YYYY-MM-DD`. Mặc định: hôm nay
`method`	string	—	Phương pháp tính. Mặc định: `MWL`

Ví dụ

GET /v1/prayer-times/ho-chi-minh?date=2024-03-15

Response

{
  "success": true,
  "data": {
    "province": "ho-chi-minh",
    "provinceName": "Hồ Chí Minh",
    "date": "2024-03-15",
    "hijriDate": "4 Ramadan 1445",
    "method": "MWL",
    "coordinates": {
      "latitude": 10.8231,
      "longitude": 106.6297
    },
    "timings": {
      "fajr": "04:47",
      "sunrise": "06:02",
      "dhuhr": "12:05",
      "asr": "15:24",
      "maghrib": "18:08",
      "isha": "19:19"
    }
  },
  "meta": {
    "version": "1.0.0",
    "timestamp": "2024-03-15T00:00:00Z"
  }
}

GET /v1/prayer-times/coordinates

Lấy giờ cầu nguyện theo tọa độ GPS tùy ý.

Query Parameters

Tên	Loại	Bắt buộc	Mô tả
`lat`	number	✓	Vĩ độ (-90 đến 90)
`lng`	number	✓	Kinh độ (-180 đến 180)
`date`	string	—	Ngày `YYYY-MM-DD`. Mặc định: hôm nay
`method`	string	—	Phương pháp tính. Mặc định: `MWL`
`timezone`	string	—	Múi giờ. Mặc định: `Asia/Ho_Chi_Minh`

Ví dụ

GET /v1/prayer-times/coordinates?lat=10.8231&lng=106.6297

GET /v1/prayer-times/:province/month

Lấy giờ cầu nguyện cho cả tháng.

Parameters

Tên	Loại	Bắt buộc	Mô tả
`province`	string	✓	Mã tỉnh thành
`year`	number	✓	Năm (ví dụ: 2024)
`month`	number	✓	Tháng (1-12)

Ví dụ

GET /v1/prayer-times/ha-noi/month?year=2024&month=3

Phương pháp tính được hỗ trợ

Mã	Tên
`MWL`	Muslim World League (mặc định)
`ISNA`	Islamic Society of North America
`Egypt`	Egyptian General Authority
`Makkah`	Umm Al-Qura, Makkah
`Karachi`	University of Islamic Sciences

Xem thêm tại Methodology.

On this page