Chuyển đến nội dung
Minare
vi
Minare

Nhà phát triển

Giờ cầu nguyện, qua API và MCP

Công cụ tính của các ứng dụng Minare: giờ cầu nguyện ở bất kỳ đâu trên Trái Đất, lịch giờ hằng tháng, qibla và ngày Hijri. Diyanet là phương pháp mặc định ở Thổ Nhĩ Kỳ.

Mọi trang trên website này đều công khai và miễn phí. API và máy chủ MCP dùng để đưa giờ cầu nguyện vào ứng dụng hoặc trợ lý của riêng bạn, và cần có khóa.

Các gói

Trial

Để dùng thử và cho dự án nhỏ. Không cần thẻ.

Miễn phí

  • 10 yêu cầu mỗi phút
  • 1.000 yêu cầu mỗi tháng
  • Toàn bộ API JSON
  • Máy chủ MCP
  • Mọi phương pháp tính
Lấy khóa

Pro

Cho ứng dụng, website và bot.

$9/tháng

  • 60 yêu cầu mỗi phút
  • 100.000 yêu cầu mỗi tháng
  • Toàn bộ API JSON
  • Máy chủ MCP
  • Mọi phương pháp tính
Lấy khóa

Business

Cho lưu lượng lớn và tổ chức.

$49/tháng

  • 300 yêu cầu mỗi phút
  • 1.000.000 yêu cầu mỗi tháng
  • Toàn bộ API JSON
  • Máy chủ MCP
  • Mọi phương pháp tính
Lấy khóa

Giới hạn thuộc về gói của tài khoản; yêu cầu API và MCP được tính vào cùng một hạn mức. Các gói trả phí được tính theo tháng qua Polar và có thể hủy từ bảng điều khiển bất cứ lúc nào.

Cách lấy khóa

  1. 1Đăng nhập bằng Apple, Google hoặc email. Không có mật khẩu, và tài khoản Minare Kur'an của bạn cũng dùng được ở đây.
  2. 2Tạo khóa trong bảng điều khiển nhà phát triển. Khóa chỉ hiển thị một lần; chúng tôi chỉ lưu mã băm của nó.
  3. 3Thêm khóa vào các yêu cầu của bạn. Bạn bắt đầu với gói Trial; hãy nâng cấp từ bảng điều khiển khi cần thêm.
Lấy khóa

Xác thực

Gửi khóa của bạn kèm mọi yêu cầu: Authorization: Bearer mk_… hoặc X-API-Key: mk_…. Yêu cầu không có khóa hợp lệ nhận mã 401, khóa đã thu hồi nhận 403; nội dung phản hồi có liên kết đến trang này.

Ví dụ

curl https://minare.app/api/v1/times?city=istanbul \
  -H "Authorization: Bearer mk_…"

Điểm cuối

  • GET /api/v1/times?city=Kadıköy

    Một ngày: Imsak, Fajr, bình minh, Dhuhr, Asr, Maghrib, Isha và các giờ bổ sung

  • GET /api/v1/month?city=london&year=2027&month=2

    Lịch giờ hằng tháng

  • GET /api/v1/next?lat=41.01&lon=28.98

    Buổi cầu nguyện kế tiếp và số giây còn lại

  • GET /api/v1/qibla?city=berlin

    Hướng qibla và khoảng cách đến Kaaba

  • GET /api/v1/cities?q=ist

    Tìm thành phố và quận

  • GET /api/v1/hijri?date=2027-02-08

    Ngày Hijri

Tham số chung

city
Tên thành phố (Kadıköy, London) hoặc đường dẫn minare.app (turkey/istanbul/kadikoy)
lat, lon, tz
Dùng tọa độ thay cho thành phố; thêm tz cho múi giờ
date
YYYY-MM-DD; mặc định là hôm nay theo giờ địa phương
method
Phương pháp tính; được chọn theo quốc gia nếu bỏ qua
madhab
shafi hoặc hanafi; được chọn theo quốc gia nếu bỏ qua

Giới hạn

Mọi phản hồi đều kèm RateLimit-Limit, RateLimit-Remaining và RateLimit-Reset cho giới hạn mỗi phút, và X-Quota-Limit, X-Quota-Remaining và X-Quota-Reset cho hạn mức hằng tháng. Vượt giới hạn bạn nhận mã 429 kèm Retry-After.

Tài liệu