API Overview
Tổng quan về Islam.io.vn REST API
Base URL
https://api.islam.io.vn/v1Authentication
Hiện tại API ở giai đoạn public beta — không cần authentication. Rate limit áp dụng theo IP.
| Tier | Rate Limit |
|---|---|
| Public | 100 req/min |
| Registered (sắp ra) | 1000 req/min |
Endpoints
Prayer Times
GET /v1/prayer-times/:province
GET /v1/prayer-times/coordinatesTính giờ cầu nguyện theo tỉnh thành hoặc tọa độ GPS.
Mosques
GET /v1/mosques
GET /v1/mosques/:idDanh sách và thông tin thánh đường tại Việt Nam.
Islamic Calendar
GET /v1/calendar
GET /v1/calendar/eventsLịch Hijri và các sự kiện Hồi giáo.
Response Format
Tất cả response trả về JSON với cấu trúc chuẩn:
{
"success": true,
"data": { ... },
"meta": {
"version": "1.0.0",
"timestamp": "2024-01-01T00:00:00Z"
}
}Error Response
{
"success": false,
"error": {
"code": "PROVINCE_NOT_FOUND",
"message": "Province 'xyz' not found. See /v1/provinces for valid values."
}
}Versioning
API được versioned qua URL path (/v1/, /v2/). Breaking changes sẽ tạo version mới, version cũ được maintain ít nhất 12 tháng.
Status
Xem trạng thái API tại: status.islam.io.vn (sắp ra)