Namaz Vakitleri API – Ücretsiz JSON Servisi

Kısaca

Temel adres: https://namazvakitleri.io/api
Biçim: JSON (UTF-8)
İstek yöntemi: GET
Kimlik doğrulama: Gerekmez
Tarayıcıdan erişim: Açık (CORS: *)
Saat dilimi: Europe/Istanbul
Kapsam: 81 il, 973 ilçe
Ücret: Yok

Kullanım koşulları

Vakitler Diyanet İşleri Başkanlığı'nın yöntemiyle hesaplanır, ancak bu servis Diyanet'in resmî servisi değildir. Bağlayıcı kaynak Diyanet'in yayımladığı takvimdir. Uygulamanızda bunu belirtmenizi rica ederiz.

Serbestçe kullanabilirsiniz. Kişisel ya da ticari, fark etmez. Karşılığında verileri gösterdiğiniz yerde namazvakitleri.io bağlantısıyla kaynak gösterin.
Gereğinden fazla istek atmayın. Bir yerin vakitleri gün içinde değişmez; bir kullanıcı için günde bir istek yeter. Sonuçları kendi tarafınızda saklayın, her ekran açılışında yeniden çekmeyin.
Cevaptaki Cache-Control süresine uyun. Vakit cevapları gece yarısına kadar, arama ve konum cevapları 24 saat geçerlidir.
Aylık sorgu tek istektir. Bir ayın otuz gününü otuz ayrı istekle çekmek yerine ay parametresini kullanın.
Aşırı yük oluşturan çağrılar uyarısız engellenebilir. Yoğun kullanım planlıyorsanız önce [email protected] adresine yazın; birlikte bir yol buluruz.

Kaynak gösterimi

<a href="https://namazvakitleri.io">Namaz vakitleri: namazvakitleri.io</a>

Yer kodları

Her yerin bir kodu (slug) vardır ve tüm uç noktalar bu kodu kullanır. İller tek kelimedir: istanbul, ankara, sanliurfa. İlçeler bağlı oldukları ilin kodu ile başlar: istanbul-kadikoy, konya-eregli, hatay-antakya.

Türkçe harfler koda çevrilirken sadeleşir: ç→c, ğ→g, ı ve i→i, ö→o, ş→s, ü→u. Emin değilseniz /api/ara ile arayın; sitedeki tüm iller sayfasında da her yerin bağlantısında aynı kod geçer.

Namaz vakitleri

GET /api/vakit

Bir yerin namaz vakitleri. Tarih verilmezse bugünün vakitlerini, ay verilirse o ayın tamamını döndürür. Tek gün sorulsa bile cevap her zaman gunler dizisi içindedir; böylece istemci tarafında iki ayrı durum ele almanız gerekmez.

Parametreler

Parametre	Zorunlu	Açıklama
`yer`	Evet	Yer kodu. Örnek: `istanbul`, `istanbul-kadikoy`
`gun`	Hayır	Tek bir gün, `YYYY-AA-GG` biçiminde. Verilmezse bugün alınır. 2026–2030 yılları arası.
`ay`	Hayır	Ayın tamamı, `YYYY-AA` biçiminde. `gun` ile birlikte kullanılamaz.

Örnek istekler

https://namazvakitleri.io/api/vakit?yer=istanbul
https://namazvakitleri.io/api/vakit?yer=istanbul-kadikoy&gun=2026-08-15
https://namazvakitleri.io/api/vakit?yer=konya&ay=2026-08

Cevaptaki alanlar

Alan	Tür	Açıklama
`yer`	nesne	Yerin adı, türü (`il` / `ilce`), bağlı olduğu il, koordinatları ve rakımı.
`yontem`	nesne	Hesapta kullanılan güneş açıları ve dakika cinsinden temkin değerleri. Başka bir kaynakla farkı buradan izleyebilirsiniz.
`kible.aci`	sayı	Kuzeyden saat yönünde derece.
`kible.kibleSaati`	nesne / null	Gölgenin kıbleyi gösterdiği an. Yalnız tek gün sorgusunda doludur; aylık sorguda ve güneşin o gün kıble yönüne hiç gelmediği yerlerde `null`.
`gunler[]`	dizi	Sorulan her gün için bir kayıt.
`gunler[].vakitler`	nesne	Altı vakit: `imsak`, `gunes`, `ogle`, `ikindi`, `aksam`, `yatsi`. Her biri `saat` (`SS:DD`) ve `iso` (ISO 8601, saat dilimi ekli) içerir.
`gunler[].kerahat`	nesne	Namaz kılmanın mekruh olduğu üç zaman: `israk`, `istiva`, `isfirar`.
`gunler[].hicri`	nesne	Hicrî karşılık. Cetvel hesabıdır; Diyanet takviminden bir gün sapabilir. Dinî günler için bu alana değil, `diniGun` alanına bakın.
`gunler[].diniGun`	nesne	Yalnız o güne dinî bir gün ya da gece denk geldiğinde bulunur. `gece` alanı `true` ise kandil, bir önceki akşam idrak edilir.

Örnek cevap

Aşağıdaki cevap bu sayfa açıldığında gerçekten üretildi: /api/vakit?yer=istanbul

{
    "yer": {
        "slug": "istanbul",
        "ad": "İstanbul",
        "tamAd": "İstanbul",
        "tur": "il",
        "il": "İstanbul",
        "ilSlug": "istanbul",
        "bolge": "Marmara Bölgesi",
        "plaka": 34,
        "enlem": 41.01384,
        "boylam": 28.94966,
        "rakim": 39,
        "url": "https://namazvakitleri.io/namaz-vakitleri-istanbul"
    },
    "saatDilimi": "Europe/Istanbul",
    "yontem": {
        "ad": "Diyanet İşleri Başkanlığı",
        "imsakAcisi": -18.0,
        "yatsiAcisi": -17.0,
        "ufukAcisi": -0.8333,
        "ikindiGolgeKatsayisi": 1.0,
        "rakimHesabaKatildi": false,
        "temkinDakika": {
            "imsak": 0.0,
            "gunes": -7.0,
            "ogle": 5.0,
            "ikindi": 5.0,
            "aksam": 8.0,
            "yatsi": 1.0
        }
    },
    "kible": {
        "aci": 151.56,
        "yon": "güneydoğu",
        "kabeUzakligiKm": 2406.7,
        "kibleSaati": {
            "saat": "12:12",
            "iso": "2026-08-15T12:12:30+03:00"
        }
    },
    "gunSayisi": 1,
    "gunler": [
        {
            "tarih": "2026-08-15",
            "gunAdi": "Cumartesi",
            "hicri": {
                "gun": 2,
                "ay": 3,
                "yil": 1448,
                "ayAdi": "Rebiülevvel",
                "metin": "2 Rebiülevvel 1448"
            },
            "vakitler": {
                "imsak": {
                    "ad": "İmsak",
                    "saat": "04:29",
                    "iso": "2026-08-15T04:29:00+03:00"
                },
                "gunes": {
                    "ad": "Güneş",
                    "saat": "06:07",
                    "iso": "2026-08-15T06:07:00+03:00"
                },
                "ogle": {
                    "ad": "Öğle",
                    "saat": "13:14",
                    "iso": "2026-08-15T13:14:00+03:00"
                },
                "ikindi": {
                    "ad": "İkindi",
                    "saat": "17:04",
                    "iso": "2026-08-15T17:04:00+03:00"
                },
                "aksam": {
                    "ad": "Akşam",
                    "saat": "20:11",
                    "iso": "2026-08-15T20:11:00+03:00"
                },
                "yatsi": {
                    "ad": "Yatsı",
                    "saat": "21:41",
                    "iso": "2026-08-15T21:41:00+03:00"
                }
            },
            "kerahat": {
                "israk": {
                    "ad": "İşrak",
                    "bas": {
                        "saat": "06:07",
                        "iso": "2026-08-15T06:07:00+03:00"
                    },
                    "son": {
                        "saat": "06:52",
                        "iso": "2026-08-15T06:52:00+03:00"
                    }
                },
                "istiva": {
                    "ad": "İstivâ",
                    "bas": {
                        "saat": "12:29",
                        "iso": "2026-08-15T12:29:00+03:00"
                    },
                    "son": {
                        "saat": "13:14",
                        "iso": "2026-08-15T13:14:00+03:00"
                    }
                },
                "isfirar": {
                    "ad": "İsfirâr",
                    "bas": {
                        "saat": "19:26",
                        "iso": "2026-08-15T19:26:00+03:00"
                    },
                    "son": {
                        "saat": "20:11",
                        "iso": "2026-08-15T20:11:00+03:00"
                    }
                }
            }
        }
    ],
    "kaynak": {
        "site": "https://namazvakitleri.io",
        "lisans": "Kaynak gösterilerek serbestçe kullanılabilir.",
        "uyari": "Vakitler Diyanet İşleri Başkanlığı yöntemiyle hesaplanır; bağlayıcı kaynak Diyanet'in yayımladığı takvimdir."
    }
}

Yer arama

GET /api/ara

İl ve ilçe adlarında arama yapar. Kelime başındaki eşleşmeler önce gelir, sonuçlar nüfusa göre sıralanır. Türkçe harf kullanmanız şart değildir: kadikoy da Kadıköy da aynı sonucu verir.

Parametreler

Parametre	Zorunlu	Açıklama
`q`	Evet	Aranacak metin. Harf, rakam, boşluk, kesme işareti ve kısa çizgi; en çok 60 karakter.
`adet`	Hayır	Kaç sonuç dönsün: 1–25 arası. Varsayılan 10.

Örnek istek

https://namazvakitleri.io/api/ara?q=kadikoy&adet=5

Örnek cevap

{
    "sorgu": "kadikoy",
    "adet": 1,
    "sonuc": [
        {
            "slug": "istanbul-kadikoy",
            "ad": "Kadıköy",
            "il": "İstanbul",
            "url": "https://namazvakitleri.io/namaz-vakitleri-istanbul-kadikoy"
        }
    ]
}

il alanı ilçelerde bağlı olunan ilin adını verir; bir il kaydında boştur, çünkü listede adın yanına ikinci kez yazılması gerekmez.

Koordinattan en yakın yer

GET /api/konum

Bir enlem–boylam çiftine en yakın il veya ilçeyi döndürür. Sitedeki "konumumu bul" düğmesi de bunu kullanır. İki ondalık basamak yaklaşık bir kilometrelik hassasiyet demektir ve en yakın yeri bulmaya fazlasıyla yeter; kullanıcınızın tam konumunu göndermeniz gerekmez.

Parametreler

Parametre	Zorunlu	Açıklama
`enlem`	Evet	−90 ile 90 arası. Ondalık ayırıcı nokta ya da virgül olabilir.
`boylam`	Evet	−180 ile 180 arası.

Örnek istek

https://namazvakitleri.io/api/konum?enlem=41.02&boylam=28.98

Örnek cevap

{
    "slug": "istanbul-beyoglu",
    "ad": "Beyoğlu",
    "il": "İstanbul",
    "uzaklik": 2.0,
    "url": "https://namazvakitleri.io/namaz-vakitleri-istanbul-beyoglu"
}

uzaklik kilometre cinsindendir ve verilen noktayla bulunan yerin merkezi arasındaki kuş uçuşu mesafedir.

Takvim dosyası (iCalendar)

GET /takvim/{yer}.ics

Önümüzdeki 60 günün vakitlerini takvim dosyası olarak indirir. Her vakit beş dakikalık bir kayıttır ve gün boyu "meşgul" göstermez. iPhone Takvim, Google Takvim ve Outlook dosyayı doğrudan açar.

https://namazvakitleri.io/takvim/istanbul.ics
https://namazvakitleri.io/takvim/istanbul-kadikoy.ics

Adresi indirmek yerine abone olarak eklerseniz takviminiz kendini haftada bir tazeler ve vakitler tükenmez. Google Takvim'de "Diğer takvimler → URL'den" seçeneği, iPhone'da "Takvim hesabı ekle → Diğer → Abone olunan takvim" bunun içindir.

Dosyadaki saatler UTC olarak yazılır; takvim programınız kendi saat diliminize çevirerek gösterir. Türkiye içinde bakıldığında ekranda sitedeki saatin aynısı görünür.

Hatalar

Bir şey ters gittiğinde cevap gövdesi tek alanlı bir nesnedir ve durum kodu HTTP düzeyinde de doğrudur; sadece gövdeye bakıp 200 varsaymayın.

{
    "hata": "Yer bulunamadı: atlantis. Doğru kodu /api/ara ile bulabilirsiniz."
}

Kod	Ne zaman
`400`	Zorunlu bir parametre eksik ya da biçimi yanlış. Yanlış yazılmış bir parametre sessizce yok sayılmaz, hata döner.
`404`	Yer kodu tanınmıyor ya da koordinata karşılık gelen bir yer yok.
`405`	GET dışında bir istek yöntemi kullanıldı.

Doğruluk ve sınırlar

Vakitler her yerin kendi koordinatı için hesaplanır, ilin merkezinden kopyalanmaz. Diyanet'in yayımladığı takvimle karşılaştırıldığında fark genellikle bir dakikanın altındadır. Hesaplama yöntemi ayrı bir sayfada ayrıntısıyla anlatılıyor.
İkindi, Diyanet'in de esas aldığı gibi gölge katsayısı 1 ile hesaplanır; bu, İmâmeyn'in ve cumhurun görüşüdür ve Türkiye'de camilerde okunan ezan buna göredir. Ebû Hanîfe'ye nispet edilen 2 katsayısı mevsime göre yarım ila bir saat sonrasına denk gelir. API şimdilik yalnız Diyanet değerini döndürüyor.
Tarih aralığı 2026–2030 yıllarıdır. Dinî günler bu aralık için hazır bir listeden okunur; liste, hicrî aylardaki sabit günlerin astronomik hesapla çevrilmesine dayanır ve sayfaların üstündeki hicrî tarihi üreten cetvel hesabından bağımsızdır. Bağlayıcı olan, Diyanet'in ilan ettiği takvimdir.
Alanlar zamanla eklenebilir; var olan alanların adı ve anlamı değişmez. Bilmediğiniz alanları yok saymanız yeterlidir.

Soru ve geri bildirim

Yanlış gördüğünüz bir vakit, eksik bir yer ya da ihtiyacınız olan bir alan varsa yazın: [email protected]. Hangi yer ve hangi tarih olduğunu eklerseniz karşılaştırması kolay olur.