Ezan Vakti İmsakiyem API Dokümantasyonu

v1.0.0 | Son güncelleme: 14 Mart 2025

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

Hızlı Başlangıç

# Ankara'nın ilçelerini listeleme
curl -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"

API Endpoint'leri

🌍 Coğrafi Konum Verileri

Ülkeler

Endpoint	Method	Açıklama
`/api/locations/countries`	GET	Tüm ülkeleri listeler
`/api/locations/countries/{countryId}`	GET	Ülke detayları
`/api/locations/search/countries`	GET	Ülke arama

Parametreler:

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

Örnek Kullanım:

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

Şehirler

Endpoint	Method	Açıklama
`/api/locations/states`	GET	Ülke ID'sine göre şehirler
`/api/locations/states/{stateId}`	GET	Şehir detayları
`/api/locations/search/states`	GET	Şehir arama

Parametreler:

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

İlçeler

Endpoint	Method	Açıklama
`/api/locations/districts`	GET	Şehir ID'sine göre ilçeler
`/api/locations/districts/{districtId}`	GET	İlçe detayları
`/api/locations/search/districts`	GET	İlçe arama

Parametreler:

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

🕋 Namaz Vakitleri

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

Parametreler:

Parametre	Tür	Zorunluluk	Açıklama
`districtId`	Path	Evet	İlçe ID'si
`period`	Path	Evet	`daily`/`weekly`/`monthly`/`yearly`/`range` varsayılan: `monthly`
`startDate`	Query	Opsiyonel	`YYYY-MM-DD`
`endDate`	Query	Opsiyonel	`YYYY-MM-DD`
`page`	Query	Hayır	Varsayılan: 1
`limit`	Query	Hayır	Varsayılan: 100

Ö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)

⚠️ Kullanım Sınırlamaları

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

Loglama Politikası

Ö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

❌ Hata Yönetimi

HTTP Kodu	Tip	Çözüm Önerisi
400	Geçersiz Parametre	Gerekli parametreleri kontrol edin
404	Kaynak Bulunamadı	ID değerlerini doğrulayın
429	Limit Aşıldı	5 dakika bekleyip tekrar deneyin
500	Sunucu Hatası

API Dokümantasyon Kaynakları

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

📝 Lisans

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.

İletişim

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

Kanal	Detay
E-posta	karademirbayburt@gmail.com
LinkedIn	Mustafa Karademir

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

Ayrıca eklemeyi düşündüğüm özellikler

Coğrafi Koordinat Desteği

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

Çok Dilli Response

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

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