Přeskočit na obsah
Minare
cs
Minare

Pro vývojáře

Časy modliteb přes API a MCP

Výpočetní engine aplikací Minare: časy modliteb kdekoli na Zemi, měsíční rozpisy, qibla a datum podle hidžry. Diyanet je výchozí metodou v Turecku.

Každá stránka tohoto webu je veřejná a zdarma. API a server MCP slouží k tomu, abyste časy dostali do vlastní aplikace nebo asistenta, a vyžadují klíč.

Plány

Trial

Na vyzkoušení a malé projekty. Karta není potřeba.

Zdarma

  • 10 požadavků za minutu
  • 1 000 požadavků za měsíc
  • Celé API JSON
  • Server MCP
  • Každá metoda výpočtu
Získat klíč

Pro

Pro aplikace, weby a boty.

$9/měsíc

  • 60 požadavků za minutu
  • 100 000 požadavků za měsíc
  • Celé API JSON
  • Server MCP
  • Každá metoda výpočtu
Získat klíč

Business

Pro vysoký provoz a organizace.

$49/měsíc

  • 300 požadavků za minutu
  • 1 000 000 požadavků za měsíc
  • Celé API JSON
  • Server MCP
  • Každá metoda výpočtu
Získat klíč

Limity patří k plánu vašeho účtu; požadavky API a MCP se počítají do stejné kvóty. Placené plány se účtují měsíčně přes Polar a lze je kdykoli zrušit v panelu.

Jak získat klíč

  1. 1Přihlaste se přes Apple, Google nebo e-mail. Žádné heslo neexistuje a váš účet Minare Kur'an funguje i tady.
  2. 2Vytvořte klíč ve vývojářském panelu. Zobrazí se jen jednou; uchováváme pouze jeho hash.
  3. 3Přidejte klíč do svých požadavků. Začínáte s plánem Trial; až budete potřebovat víc, přejděte na vyšší plán v panelu.
Získat klíč

Ověřování

Posílejte klíč s každým požadavkem: Authorization: Bearer mk_… nebo X-API-Key: mk_…. Požadavky bez platného klíče dostanou 401, zrušené klíče 403; tělo odpovědi odkazuje na tuto stránku.

Příklad

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

Endpointy

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

    Jeden den: Imsak, Fajr, východ slunce, Dhuhr, Asr, Maghrib, Isha a další časy

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

    Měsíční rozpis

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

    Příští modlitba a zbývající sekundy

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

    Směr qiblu a vzdálenost ke Kaabě

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

    Hledat města a okresy

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

    Datum podle hidžry

Společné parametry

city
Název města (Kadıköy, London) nebo cesta na minare.app (turkey/istanbul/kadikoy)
lat, lon, tz
Souřadnice místo města; časové pásmo doplníte parametrem tz
date
RRRR-MM-DD; pokud se vynechá, dnešní den v místním čase
method
Metoda výpočtu; pokud se vynechá, zvolí se podle země
madhab
shafi nebo hanafi; pokud se vynechá, zvolí se podle země

Limity

Každá odpověď obsahuje RateLimit-Limit, RateLimit-Remaining a RateLimit-Reset pro limit za minutu a X-Quota-Limit, X-Quota-Remaining a X-Quota-Reset pro měsíční kvótu. Při překročení limitu dostanete 429 s Retry-After.

Dokumentace