Перейти до вмісту
Minare
uk
Minare

Розробникам

Час намазів через API та MCP

Обчислювальний рушій застосунків Minare: час намазів у будь-якій точці Землі, місячні розклади, кібла та дата за хіджрою. У Туреччині методом за замовчуванням є Diyanet.

Кожна сторінка цього сайту публічна й безкоштовна. API та сервер MCP призначені для того, щоб передати час у ваш власний застосунок чи асистент, і для них потрібен ключ.

Плани

Пробний

Для спроб і невеликих проєктів. Картка не потрібна.

Безкоштовно

  • 10 запитів на хвилину
  • 1 000 запитів на місяць
  • Увесь JSON API
  • Сервер MCP
  • Усі методи розрахунку
Отримати ключ

Pro

Для застосунків, сайтів і ботів.

$9/міс.

  • 60 запитів на хвилину
  • 100 000 запитів на місяць
  • Увесь JSON API
  • Сервер MCP
  • Усі методи розрахунку
Отримати ключ

Бізнес

Для великого трафіку й організацій.

$49/міс.

  • 300 запитів на хвилину
  • 1 000 000 запитів на місяць
  • Увесь JSON API
  • Сервер MCP
  • Усі методи розрахунку
Отримати ключ

Ліміти належать до плану вашого облікового запису; запити API та MCP враховуються в одній квоті. Платні плани оплачуються щомісяця через Polar і можуть бути скасовані з панелі будь-коли.

Отримання ключа

  1. 1Увійдіть через Apple, Google або пошту. Пароля немає, а ваш обліковий запис Minare Коран працює й тут.
  2. 2Створіть ключ у панелі розробника. Він показується лише раз; ми зберігаємо тільки його хеш.
  3. 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
РРРР-ММ-ДД; якщо не вказано, сьогодні за місцевим часом
method
Метод розрахунку; якщо не вказано, обирається за країною
madhab
shafi або hanafi; якщо не вказано, обирається за країною

Ліміти

Кожна відповідь містить RateLimit-Limit, RateLimit-Remaining і RateLimit-Reset для ліміту на хвилину, а також X-Quota-Limit, X-Quota-Remaining і X-Quota-Reset для місячної квоти. Після перевищення ліміту ви отримаєте 429 із Retry-After.

Документація