Разработчикам
Время намазов через 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Войдите с ключом доступа (passkey) или создайте аккаунт с помощью e-mail. Пароля нет, а ваш аккаунт 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.