Preskoči na sadržaj

Developeri

Namaski vakti putem API-ja i MCP-a

Mehanizam izračuna aplikacija Minare: namaski vakti bilo gdje na Zemlji, mjesečne vaktije, kibla i hidžretski datum. Diyanet je zadana metoda u Turskoj.

Svaka stranica na ovoj web stranici je javna i besplatna. API i MCP server služe za prenošenje vakata u vašu vlastitu aplikaciju ili asistenta i za njih je potreban ključ.

Planovi

Trial

Za isprobavanje i male projekte. Kartica nije potrebna.

Besplatno

  • 10 zahtjeva u minuti
  • 1.000 zahtjeva mjesečno
  • Cijeli JSON API
  • MCP server
  • Sve metode izračuna
Nabavi ključ

Pro

Za aplikacije, web stranice i botove.

$9/mjesečno

  • 60 zahtjeva u minuti
  • 100.000 zahtjeva mjesečno
  • Cijeli JSON API
  • MCP server
  • Sve metode izračuna
Nabavi ključ

Business

Za veliki promet i organizacije.

$49/mjesečno

  • 300 zahtjeva u minuti
  • 1.000.000 zahtjeva mjesečno
  • Cijeli JSON API
  • MCP server
  • Sve metode izračuna
Nabavi ključ

Ograničenja pripadaju planu vašeg računa; API i MCP zahtjevi troše istu kvotu. Plaćeni planovi naplaćuju se mjesečno putem Polara i mogu se u bilo kojem trenutku otkazati na kontrolnoj tabli.

Kako dobiti ključ

  1. 1Prijavite se putem Applea, Googlea ili e-pošte. Nema lozinke, a vaš Minare Kur'an račun radi i ovdje.
  2. 2Kreirajte ključ na kontrolnoj tabli za developere. Prikazuje se samo jednom; mi čuvamo samo njegov hash.
  3. 3Dodajte ključ svojim zahtjevima. Počinjete s planom Trial; nadogradite ga na kontrolnoj tabli kada vam zatreba više.
Nabavi ključ

Autentifikacija

Šaljite svoj ključ uz svaki zahtjev: Authorization: Bearer mk_… ili X-API-Key: mk_…. Zahtjevi bez važećeg ključa dobijaju 401, opozvani ključevi 403; tijelo odgovora sadrži link na ovu stranicu.

Primjer

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

Endpointi

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

    Jedan dan: imsak, sabah, izlazak sunca, podne, ikindija, akšam, jacija i dodatni vakti

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

    Mjesečna vaktija

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

    Sljedeći vakat i preostale sekunde

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

    Ugao kible i udaljenost do Kabe

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

    Pretražite gradove i okruge

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

    Hidžretski datum

Zajednički parametri

city
Naziv grada (Kadıköy, London) ili putanja na minare.app (turkey/istanbul/kadikoy)
lat, lon, tz
Koordinate umjesto grada; dodajte tz za vremensku zonu
date
YYYY-MM-DD; ako se ne navede, današnji lokalni datum
method
Metoda izračuna; ako se ne navede, bira se prema državi
madhab
shafi ili hanafi; ako se ne navede, bira se prema državi

Ograničenja

Svaki odgovor sadrži RateLimit-Limit, RateLimit-Remaining i RateLimit-Reset za ograničenje po minuti te X-Quota-Limit, X-Quota-Remaining i X-Quota-Reset za mjesečnu kvotu. Iznad ograničenja dobijate 429 s Retry-After.

Dokumentacija