Repository files navigation

Ezan Vakti İmsakiyem API, T.C. Diyanet İşleri Başkanlığı tarafından yayınlanan dünya genelindeki ülkelerin ezan vakitlerini günlük,haftalık, aylık ve yıllık olarak sunanücretsiz API hizmetidir.

Ana Özellikler:
✅ Ülke/Şehir/İlçe hiyerarşik veri erişimi
✅ Namaz vakitleri için dinamik zaman aralığı seçeneği

# Ankara'nın ilçelerini listelemecurl -X GET"https://ezanvakti.imsakiyem.com/api/locations/districts?stateId=506" \-H"Accept: application/json"

# Ankara/Polatlı ilçesinin namaz vakitlerini yıllık listeleme(ID:9220)curl -X GET"https://ezanvakti.imsakiyem.com/api/prayer-times/9220/yearly" \-H"Accept: application/json"

• İstanbul SultanBeyli Günlük Namaz Vakti
• Tekirdağ Çorlu Haftalık Namaz Vakti
• Ankara Polatlı Aylık Namaz Vakti
• Muş Bulanık Yıllık Namaz Vakti
• Almanya Hamburg WILHELMSBURG 14 Mart(2025-03-14) ile 06 Haziran(2025-06-06) Namaz Vakitleri

Parametreler:

• countryId (Path, Zorunlu)
• q (Query, Opsiyonel)

Örnek Kullanım:

GET /api/locations/countries/2 HTTP/1.1Host: ezanvakti.imsakiyem.com

Parametreler:

• countryId (Query, Zorunlu)
• stateId (Path, Zorunlu)
• q (Query, Opsiyonel)

Parametreler:

• stateId (Query, Zorunlu)
• districtId (Path, Zorunlu)
• q (Query, Opsiyonel)

GET /api/prayer-times/{districtId}/{period} HTTP/1.1

Parametreler:

Örnek İstek:

curl -X GET"https://ezanvakti.imsakiyem.com/api/prayer-times/9147/monthly?startDate=2025-02-15" \-H"Accept: application/json"

Not: monthly ve yearly bulunduğu zaman aralığında ki ayı ve yılı alır.(Örn: 16 Mart aylık veri almak istendiğinde, 1-31 Mart arasını verir)

• Rate Limit: 100 istek / 5 dakika
• Desteklenen Format:application/json

Önemli Notlar:

• Tüm IP adresleri GDPR uyumlu şekilde anonimleştirilir
• Performans metrikleri sunucu optimizasyonu için kullanılır
• Günlükler otomatik olarak 14 gün sonra silinir

Swagger Dokümanı
Swagger JSON Dokümanı
Postman Koleksiyonu

Bu proje GNU Genel Kamu Lisansı v3.0 (GPL-3.0) ile lisanslanmıştır. Bu yazılımı kullanabilir, değiştirebilir ve dağıtabilirsiniz. Ancak:

• Kaynak kodunu paylaşmak zorundasınız
• Değişiklikleri belgelendirmelisiniz
• Aynı lisansı kullanmalısınız
• Detaylı bilgi için LICENSE dosyasına bakınız.

Hata, öneri, istek ve şikayet ne varsa alttaki iletişim kanallarından iletebilirsiniz.

Not: Tüm tarihler ISO 8601 (YYYY-MM-DD) formatında olmalıdır. Bölge verileri hiyerarşik erişim gerektirir:

• Ülke → Şehir → İlçe → Namaz Vakitleri

1. Coğrafi Koordinat Desteği

• Enlem/Boylam bazlı konum sorgulama
• Hassas coğrafi bölge tespiti
• Enlem/Boylam bazlı namaz vakitleri verileri

2. Çok Dilli Response

• Dil parametresi (lang=tr/en) desteği
• Tamamen İngilizce/Türkçe ayrımı yapılmış alan adları

3. Ramazan ve özel vakitler entegrasyonu
4. Güneş, ay ve kıble verileri
5. Websocket üzerinden gerçek zamanlı bildirimler
6. Mobil SDK'lar (Android/iOS)
7. Hesaplama yöntemlerine göre namaz vakitleri verisi