Vai al contenuto
Minare
it
Minare

Sviluppatori

Orari di preghiera, via API e MCP

Il motore di calcolo delle app Minare: orari di preghiera ovunque sulla Terra, orari mensili, la qibla e la data hijri. Il Diyanet è il metodo predefinito in Turchia.

Ogni pagina di questo sito è pubblica e gratuita. L'API e il server MCP servono a portare gli orari nella tua app o nel tuo assistente, e richiedono una chiave.

Piani

Trial

Per provare e per piccoli progetti. Nessuna carta richiesta.

Gratis

  • 10 richieste al minuto
  • 1000 richieste al mese
  • L'intera API JSON
  • Il server MCP
  • Tutti i metodi di calcolo
Ottieni una chiave

Pro

Per app, siti web e bot.

$9/mese

  • 60 richieste al minuto
  • 100.000 richieste al mese
  • L'intera API JSON
  • Il server MCP
  • Tutti i metodi di calcolo
Ottieni una chiave

Business

Per traffico elevato e organizzazioni.

$49/mese

  • 300 richieste al minuto
  • 1.000.000 richieste al mese
  • L'intera API JSON
  • Il server MCP
  • Tutti i metodi di calcolo
Ottieni una chiave

I limiti dipendono dal piano del tuo account; le richieste API e MCP contano sulla stessa quota. I piani a pagamento sono fatturati mensilmente tramite Polar e possono essere annullati dalla dashboard in qualsiasi momento.

Come ottenere una chiave

  1. 1Accedi con Apple, Google o la tua e-mail. Non c'è alcuna password, e anche il tuo account Minare Qur'an funziona qui.
  2. 2Crea una chiave nella dashboard sviluppatori. Viene mostrata una sola volta; ne conserviamo solo un hash.
  3. 3Aggiungi la chiave alle tue richieste. Parti con il piano Trial; passa a un piano superiore dalla dashboard quando ti serve di più.
Ottieni una chiave

Autenticazione

Invia la tua chiave con ogni richiesta: Authorization: Bearer mk_… oppure X-API-Key: mk_…. Le richieste senza una chiave valida ricevono un 401, le chiavi revocate un 403; il corpo rimanda a questa pagina.

Esempio

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

Endpoint

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

    Un giorno: Imsak, Fajr, alba, Dhuhr, Asr, Maghrib, Isha e orari aggiuntivi

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

    Gli orari del mese

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

    La prossima preghiera e i secondi che mancano

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

    Direzione della qibla e distanza dalla Kaaba

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

    Cerca città e distretti

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

    Data hijri

Parametri comuni

city
Nome della città (Kadıköy, London) o un percorso di minare.app (turkey/istanbul/kadikoy)
lat, lon, tz
Coordinate al posto di una città; aggiungi tz per il fuso orario
date
YYYY-MM-DD; oggi (ora locale) se omesso
method
Metodo di calcolo; scelto in base al paese se omesso
madhab
shafi oppure hanafi; scelto in base al paese se omesso

Limiti

Ogni risposta riporta RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset per il limite al minuto, e X-Quota-Limit, X-Quota-Remaining e X-Quota-Reset per la quota mensile. Oltre il limite ricevi un 429 con Retry-After.

Documentazione