Namaz vakti, imsak ve iftar verisi özellikle Ramazan döneminde yüksek kullanıcı ihtiyacı taşır. Fakat bu veri sadece saat listesinden ibaret değildir. İl/ilçe seçimi, hesaplama yöntemi, resmi kaynak ihtiyacı, takvim dönemi ve kullanıcıya gösterilen açıklama birlikte düşünülmelidir.
Bu rehber, API Deposu'ndaki İmsakiyem Ezan Vakti API, AlAdhan Prayer Times API, MuslimSalat Prayer Times API ve Diyanet AwqatSalah API kayıtlarını karşılaştırır.
Hızlı karşılaştırma
| API | En iyi kullanım | Kimlik doğrulama | Not |
|---|---|---|---|
| İmsakiyem | Türkiye il/ilçe odaklı vakitler | Yok | Diyanet kaynaklı veri sinyali |
| AlAdhan | Global şehir bazlı namaz vakti | Yok | Hicri takvim ve kıble desteği de var |
| MuslimSalat | Hafif şehir bazlı JSON endpointleri | API key önerilir | Basit widget ve takvim ekranları |
| Diyanet AwqatSalah | Resmi ve kurumsal kullanım | Login + Bearer token | Onboarding ve token yönetimi gerekir |
Türkiye odaklı seçim
Türkiye için il/ilçe hiyerarşisi önemliyse İmsakiyem pratik bir başlangıçtır. Ülke, il, ilçe ve periyot bazlı endpointlerle günlük, haftalık, aylık veya yıllık ekranlar hazırlanabilir. API anahtarı gerektirmemesi geliştirme hızını artırır.
Kurumsal veya resmi veri ihtiyacında Diyanet AwqatSalah daha doğru aday olabilir. Ancak kimlik doğrulama, token yenileme ve onboarding süreci olduğu için entegrasyon maliyeti daha yüksektir. Bu farkı ürün planında baştan hesaba katmak gerekir.
Global ve ek özellikler
AlAdhan, global şehir bazlı namaz vakti, hicri tarih dönüşümü ve kıble yönü gibi ek özellikler sunar. Çok ülkeli bir uygulama veya İslami takvim widget'ı geliştiriyorsanız bu geniş kapsam işe yarar.
MuslimSalat daha hafif şehir bazlı JSON endpointleriyle hızlı prototip için değerlendirilebilir. Dokümantasyon API key kullanımını önerdiği için üretimde kota ve limit koşulları tekrar kontrol edilmelidir.
Ramazan takvimi tasarımı
Ramazan ekranlarında kullanıcı genellikle "bugün imsak kaçta" ve "iftar kaçta" sorularını sorar. Bu nedenle sade günlük kart, aylık takvim, şehir/ilçe seçimi ve paylaşılabilir bağlantı iyi çalışır. Ancak Ramazan başlangıç ve bitişi bölgesel hilal gözlemi nedeniyle farklı yorumlanabilir; uygulama metni bu konuda kesin dini hüküm verir gibi yazılmamalıdır.
Aylık takvim verisi genellikle cache için uygundur. Günlük kartlarda ise kullanıcıya seçilen lokasyon, kaynak ve güncelleme zamanı gösterilmelidir. Yanlış lokasyon seçimi en sık kullanıcı hatalarından biridir.
Üretim mimarisi
Vakit verisini frontend'den doğrudan çekmek küçük widget için mümkün olabilir, ancak daha iyi model backend cache kullanmaktır. Böylece aynı şehir için binlerce kullanıcı aynı veriyi tekrar tekrar sağlayıcıdan çekmez. Ayrıca provider değişirse UI etkilenmez.
Kendi modelinizde locationId, source, date, imsak, gunes, ogle, ikindi, aksam, yatsi, fetchedAt alanlarını ayırın. Böylece İmsakiyem, AlAdhan veya Diyanet kaynakları aynı UI içinde normalize edilebilir.
Lokasyon seçimi
Namaz vakti uygulamalarında en sık hata yanlış lokasyon seçimidir. Kullanıcı il seçtiğini sanırken ilçe verisi gerekebilir veya global API şehir adını farklı ülkeyle eşleştirebilir. Bu yüzden il, ilçe ve ülke alanları açıkça gösterilmeli; otomatik konum kullanılıyorsa kullanıcıya manuel düzeltme seçeneği verilmelidir.
Türkiye odaklı bir ürün için il/ilçe hiyerarşisi global şehir aramasından daha güvenilir olabilir. Çok ülkeli ürünlerde ise hesaplama yöntemi, ülke ayarı ve saat dilimi bilgisi kullanıcıya açık şekilde sunulmalıdır.
İçerik dili ve hassasiyet
İmsak ve iftar vakti dini pratikle ilişkili olduğu için metin dili dikkatli olmalıdır. Uygulama kesin hüküm veren bir otorite gibi değil, seçilen kaynaktan gelen vakit bilgisini sunan araç gibi davranmalıdır. Farklı yöntem veya yerel uygulama olasılığı not edilebilir.
Ramazan döneminde trafik artacağı için cache, CDN ve hata fallback'i önceden test edilmelidir. En çok ihtiyaç duyulan anda boş takvim göstermek kullanıcı güvenini ciddi şekilde zedeler.
İlgili API Deposu kayıtları
Kaynaklar
Sık Sorulan Sorular
›Türkiye için namaz vakti API'si seçerken neye bakılmalı?
İl/ilçe hiyerarşisi, veri kaynağı, Ramazan takvimi desteği, cache davranışı ve resmi veri ihtiyacı birlikte değerlendirilmelidir.
›İmsak ve iftar vakitleri için hangi API pratik?
Türkiye odaklı il/ilçe akışı için İmsakiyem pratik bir seçenek olabilir. Global şehir bazlı kullanımda AlAdhan veya MuslimSalat değerlendirilebilir.
›Diyanet AwqatSalah API ne zaman tercih edilmeli?
Resmi Diyanet verisi ve kimlik doğrulamalı kurumsal kullanım gerekiyorsa AwqatSalah daha uygun adaydır. Onboarding ve token yönetimi diğer seçeneklere göre daha fazla dikkat ister.
›Ramazan takvimi verisi nasıl cache'lenmeli?
Aylık takvim verisi sık değişmediği için dönemsel cache kullanılabilir. Günlük ekranlarda yine de kaynak ve güncelleme bilgisi kullanıcıya gösterilmelidir.
