توسعه‌دهندگان
اوقات نماز، با API و MCP
موتور محاسبهٔ برنامه‌های Minare: اوقات نماز در هر نقطهٔ زمین، جدول‌های ماهانه، قبله و تاریخ هجری. روش Diyanet در ترکیه روش پیش‌فرض است.
همهٔ صفحه‌های این وب‌سایت عمومی و رایگان‌اند. API و سرور MCP برای آوردن اوقات به برنامه یا دستیار خودتان است و به کلید نیاز دارد.
طرح‌ها
Trial
برای آزمایش و پروژه‌های کوچک. نیازی به کارت نیست.
رایگان
- 10 درخواست در دقیقه
- 1,000 درخواست در ماه
- کل JSON API
- سرور MCP
- همهٔ روش‌های محاسبه
Pro
برای برنامه‌ها، وب‌سایت‌ها و ربات‌ها.
$9/ماه
- 60 درخواست در دقیقه
- 100,000 درخواست در ماه
- کل JSON API
- سرور MCP
- همهٔ روش‌های محاسبه
Business
برای ترافیک بالا و سازمان‌ها.
$49/ماه
- 300 درخواست در دقیقه
- 1,000,000 درخواست در ماه
- کل JSON API
- سرور MCP
- همهٔ روش‌های محاسبه
محدودیت‌ها به طرح حساب شما تعلق دارند؛ درخواست‌های API و MCP از یک سهمیهٔ مشترک کسر می‌شوند. طرح‌های پولی به‌صورت ماهانه از طریق Polar صورت‌حساب می‌شوند و هر زمان می‌توان آن‌ها را از داشبورد لغو کرد.
دریافت کلید
- 1با کلید عبور وارد شوید یا با ایمیل خود حساب بسازید. گذرواژه‌ای در کار نیست و حساب Minare Qur'an شما اینجا هم کار می‌کند.
- 2در داشبورد توسعه‌دهندگان یک کلید بسازید. کلید فقط یک بار نشان داده می‌شود؛ ما فقط هش آن را نگه می‌داریم.
- 3کلید را به درخواست‌های خود اضافه کنید. کار را با طرح Trial آغاز می‌کنید؛ هر وقت به ظرفیت بیشتری نیاز داشتید، از داشبورد طرح خود را ارتقا دهید.
احراز هویت
کلید خود را با هر درخواست بفرستید: Authorization: Bearer mk_… یا X-API-Key: mk_…. درخواست‌های بدون کلید معتبر پاسخ 401 و کلیدهای باطل‌شده پاسخ 403 دریافت می‌کنند؛ بدنهٔ پاسخ به این صفحه پیوند دارد.
نمونه
curl https://minare.app/api/v1/times?city=istanbul \
-H "Authorization: Bearer mk_…"نقاط پایانی
GET /api/v1/times?city=Kadıköyیک روز: امساک، صبح، طلوع آفتاب، ظهر، عصر، مغرب، عشا و اوقات دیگر
GET /api/v1/month?city=london&year=2027&month=2جدول اوقات یک ماه
GET /api/v1/next?lat=41.01&lon=28.98نماز بعدی و ثانیه‌های باقی‌مانده
GET /api/v1/qibla?city=berlinزاویهٔ قبله و فاصله تا کعبه
GET /api/v1/cities?q=istجست‌وجوی شهرها و بخش‌ها
GET /api/v1/hijri?date=2027-02-08تاریخ هجری
پارامترهای مشترک
city- نام شهر (Kadıköy، London) یا مسیری در minare.app (turkey/istanbul/kadikoy)
lat, lon, tz- مختصات به‌جای شهر؛ برای منطقهٔ زمانی tz را اضافه کنید
date- YYYY-MM-DD؛ اگر تعیین نشود، امروزِ محلی
method- روش محاسبه؛ اگر تعیین نشود، بر اساس کشور انتخاب می‌شود
madhab- shafi یا hanafi؛ اگر تعیین نشود، بر اساس کشور انتخاب می‌شود
محدودیت‌ها
هر پاسخ برای محدودیت دقیقه‌ای سرآیندهای RateLimit-Limit، RateLimit-Remaining و RateLimit-Reset، و برای سهمیهٔ ماهانه X-Quota-Limit، X-Quota-Remaining و X-Quota-Reset را دارد. با عبور از محدودیت، پاسخ 429 همراه با Retry-After دریافت می‌کنید.