Geliştiriciler
Namaz vakitleri, API ve MCP ile
Minare uygulamalarının kullandığı hesap motoru: dünyanın her yerinde namaz vakitleri, aylık imsakiye, kıble ve Hicri tarih. Türkiye için Diyanet yöntemi varsayılandır.
Web sitesindeki bütün sayfalar herkese açık ve ücretsizdir. API ve MCP, vakitleri kendi uygulamanıza ya da asistanınıza bağlamak içindir ve bir anahtar ister.
Planlar
Deneme
Denemek ve küçük projeler için. Kart istenmez.
Ücretsiz
- dakikada 10 istek
- ayda 1.000 istek
- JSON API'nin tamamı
- MCP sunucusu
- Bütün hesaplama yöntemleri
Pro
Uygulamalar, web siteleri ve botlar için.
$9/ay
- dakikada 60 istek
- ayda 100.000 istek
- JSON API'nin tamamı
- MCP sunucusu
- Bütün hesaplama yöntemleri
Business
Yüksek trafik ve kurumlar için.
$49/ay
- dakikada 300 istek
- ayda 1.000.000 istek
- JSON API'nin tamamı
- MCP sunucusu
- Bütün hesaplama yöntemleri
Sınırlar hesabınızın planına aittir; API ve MCP istekleri aynı kotadan düşer. Ücretli planlar Polar üzerinden aylık faturalanır ve panelden istediğiniz an iptal edilebilir.
Anahtar almak
- 1Geçiş anahtarıyla (passkey) giriş yapın ya da e-postanızla bir hesap oluşturun. Parola yoktur; Minare Kur'an hesabınız burada da geçerlidir.
- 2Geliştirici panelinde bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; biz yalnızca özetini saklarız.
- 3Anahtarı isteklerinize ekleyin. Deneme planıyla başlarsınız; daha fazlası gerekirse panelden plan yükseltin.
Kimlik doğrulama
Anahtarınızı her istekte gönderin: Authorization: Bearer mk_… ya da X-API-Key: mk_…. Anahtarsız ya da geçersiz anahtarlı istekler 401, iptal edilmiş anahtarlar 403 döner; gövdede bu sayfanın adresi bulunur.
Örnek
curl https://minare.app/api/v1/times?city=istanbul \
-H "Authorization: Bearer mk_…"Uç noktalar
GET /api/v1/times?city=KadıköyBir günün vakitleri: imsak, sabah, güneş, öğle, ikindi, akşam, yatsı ve ek vakitler
GET /api/v1/month?city=london&year=2027&month=2Bir ayın imsakiyesi
GET /api/v1/next?lat=41.01&lon=28.98Sıradaki vakit ve kalan saniye
GET /api/v1/qibla?city=berlinKıble açısı ve Kâbe'ye uzaklık
GET /api/v1/cities?q=istŞehir ve ilçe arama
GET /api/v1/hijri?date=2027-02-08Hicri tarih
Ortak parametreler
city- Şehir adı (Kadıköy, London) ya da minare.app yolu (turkey/istanbul/kadikoy)
lat, lon, tz- Şehir yerine koordinat; tz ile saat dilimi verilebilir
date- YYYY-AA-GG; verilmezse yerel bugün
method- Hesaplama yöntemi; verilmezse ülkeye göre seçilir
madhab- shafi ya da hanafi; verilmezse ülkeye göre
Sınırlar
Her yanıtta dakikalık sınır için RateLimit-Limit, RateLimit-Remaining ve RateLimit-Reset, aylık kota için X-Quota-Limit, X-Quota-Remaining ve X-Quota-Reset başlıkları bulunur. Sınır aşılınca 429 ve Retry-After döner.