Naar de inhoud
Minare
nl
Minare

Ontwikkelaars

Gebedstijden, via API en MCP

De rekenmotor van de Minare-apps: gebedstijden overal op aarde, maandtijden, de qibla en de hijri-datum. Diyanet is de standaardmethode in Turkije.

Elke pagina van deze website is openbaar en gratis. De API en de MCP-server zijn bedoeld om de tijden in je eigen app of assistent te brengen, en vragen om een sleutel.

Abonnementen

Trial

Om uit te proberen en voor kleine projecten. Geen kaart nodig.

Gratis

  • 10 verzoeken per minuut
  • 1.000 verzoeken per maand
  • De hele JSON-API
  • De MCP-server
  • Elke berekeningsmethode
Sleutel aanvragen

Pro

Voor apps, websites en bots.

$9/maand

  • 60 verzoeken per minuut
  • 100.000 verzoeken per maand
  • De hele JSON-API
  • De MCP-server
  • Elke berekeningsmethode
Sleutel aanvragen

Business

Voor veel verkeer en organisaties.

$49/maand

  • 300 verzoeken per minuut
  • 1.000.000 verzoeken per maand
  • De hele JSON-API
  • De MCP-server
  • Elke berekeningsmethode
Sleutel aanvragen

Limieten horen bij het abonnement van je account; API- en MCP-verzoeken tellen mee voor hetzelfde quotum. Betaalde abonnementen worden maandelijks via Polar gefactureerd en kunnen op elk moment via het dashboard worden opgezegd.

Een sleutel aanvragen

  1. 1Log in met Apple, Google of je e-mail. Er is geen wachtwoord, en je Minare Qur'an-account werkt hier ook.
  2. 2Maak een sleutel aan in het ontwikkelaarsdashboard. Hij wordt maar één keer getoond; wij bewaren alleen een hash ervan.
  3. 3Voeg de sleutel toe aan je verzoeken. Je begint met het Trial-abonnement; upgrade via het dashboard als je meer nodig hebt.
Sleutel aanvragen

Authenticatie

Stuur je sleutel mee met elk verzoek: Authorization: Bearer mk_… of X-API-Key: mk_…. Verzoeken zonder geldige sleutel krijgen een 401, ingetrokken sleutels een 403; de body verwijst naar deze pagina.

Voorbeeld

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

Endpoints

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

    Eén dag: Imsak, Fajr, zonsopgang, Dhuhr, Asr, Maghrib, Isha en extra tijden

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

    De tijden van de maand

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

    Het volgende gebed en de resterende seconden

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

    Richting van de qibla en afstand tot de Kaaba

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

    Steden en districten zoeken

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

    Hijri-datum

Veelgebruikte parameters

city
Naam van de stad (Kadıköy, London) of een minare.app-pad (turkey/istanbul/kadikoy)
lat, lon, tz
Coördinaten in plaats van een stad; voeg tz toe voor de tijdzone
date
YYYY-MM-DD; lokale dag van vandaag als weggelaten
method
Berekeningsmethode; op basis van het land gekozen als weggelaten
madhab
shafi of hanafi; op basis van het land gekozen als weggelaten

Limieten

Elk antwoord bevat RateLimit-Limit, RateLimit-Remaining en RateLimit-Reset voor de limiet per minuut, en X-Quota-Limit, X-Quota-Remaining en X-Quota-Reset voor het maandquotum. Boven de limiet krijg je een 429 met Retry-After.

Documentatie