Namaz Vakti API

Diyanet İşleri Başkanlığı verilerine dayanan, ücretsiz ve kayıt gerektirmeyen namaz vakitleri API servisi. 209 ülke, 365 şehir ve 18.647 ilçe için namaz vakti verisi sunulmaktadır.

Base URL

https://namazvakti.mtopal.dev

Tüm istekler GET metodu ile yapılır. Yanıt formatı JSON'dır. API anahtarı veya kimlik doğrulama gerektirmez.

Kullanım Akışı

Namaz vakitlerini almak için aşağıdaki hiyerarşik akışı takip edin:

İstek Limiti (Rate Limit)

API'yi kötü niyetli kullanım ve aşırı yükten korumak için istek sınırlaması uygulanmaktadır:

Sınırı aştığınızda 429 Too Many Requests yanıtı döner. Normal kullanım için bu limitler fazlasıyla yeterlidir.

Bilgilendirme

Ülkeler

[
  {
    "UlkeAdi": "TÜRKİYE",
    "UlkeAdiEn": "TURKEY",
    "UlkeID": "2"
  },
  ...
]

Şehirler

# Türkiye'nin şehirlerini getir
GET https://namazvakti.mtopal.dev/sehirler/2

# Alternatif: query string ile
GET https://namazvakti.mtopal.dev/sehirler?ulke=2

[
  {
    "SehirAdi": "ADANA",
    "SehirAdiEn": "ADANA",
    "SehirID": "500",
    "BagliOlduguUlkeID": "2"
  },
  ...
]

İlçeler

# İstanbul'un ilçelerini getir
GET https://namazvakti.mtopal.dev/ilceler/539

[
  {
    "IlceAdi": "KADIKÖY",
    "IlceAdiEn": "KADIKOY",
    "IlceID": "9541",
    "BagliOlduguSehirID": "539"
  },
  ...
]

Namaz Vakitleri

# Kadıköy/İstanbul için namaz vakitlerini getir
GET https://namazvakti.mtopal.dev/vakitler/9541

[
  {
    "Imsak": "05:32",
    "Gunes": "07:01",
    "Ogle": "13:18",
    "Ikindi": "16:42",
    "Aksam": "19:22",
    "Yatsi": "20:43",
    "MiladiTarihKisa": "18.03.2026",
    "MiladiTarihKisaIso8601": "18.03.2026",
    "MiladiTarihUzun": "18 Mart 2026",
    "MiladiTarihUzunIso8601": "2026-03-18T00:00:00.0000000+03:00",
    "HicriTarihKisa": "18 Ramazan 1447",
    "HicriTarihUzun": "18 Ramazan 1447",
    "GreenwichOrtalamaZamani": 3
  },
  ...
]

Hata Kodları

API, hata durumunda aşağıdaki HTTP durum kodlarını ve JSON formatında hata mesajlarını döner:

Hata Yanıt Formatı

{
  "detail": "Hata açıklaması."
}

Bilinen Sorunlar

Aşağıdaki sorunlar Diyanet İşleri Başkanlığı'nın orijinal verisinden kaynaklanmaktadır:

Kod Örnekleri

JavaScript (fetch)

// Kadıköy için bugünün namaz vakitlerini al
const response = await fetch('https://namazvakti.mtopal.dev/vakitler/9541');
const vakitler = await response.json();

// Bugünün vakitleri (ilk eleman her zaman bugün)
const bugun = vakitler[0];
console.log(`İmsak: ${bugun.Imsak}, Akşam: ${bugun.Aksam}`);

Python (requests)

# pip install requests
import requests

# 1. Türkiye'nin şehirlerini al
sehirler = requests.get("https://namazvakti.mtopal.dev/sehirler/2").json()

# 2. İstanbul'u bul
istanbul = next(s for s in sehirler if s["SehirAdi"] == "İSTANBUL")

# 3. İstanbul'un ilçelerini al
ilceler = requests.get(f"https://namazvakti.mtopal.dev/ilceler/{istanbul['SehirID']}").json()

# 4. Kadıköy'ün vakitlerini al
kadikoy = next(i for i in ilceler if i["IlceAdi"] == "KADIKÖY")
vakitler = requests.get(f"https://namazvakti.mtopal.dev/vakitler/{kadikoy['IlceID']}").json()

print(f"Bugün imsak: {vakitler[0]['Imsak']}")

PHP

// Kadıköy namaz vakitlerini çek
$json = file_get_contents('https://namazvakti.mtopal.dev/vakitler/9541');
$vakitler = json_decode($json, true);
$bugun = $vakitler[0];
echo "Akşam namazı: " . $bugun['Aksam'];

cURL (Terminal)

# Ülkeleri listele
curl https://namazvakti.mtopal.dev/ulkeler

# Türkiye şehirleri
curl https://namazvakti.mtopal.dev/sehirler/2

# İstanbul ilçeleri
curl https://namazvakti.mtopal.dev/ilceler/539

# Kadıköy namaz vakitleri
curl https://namazvakti.mtopal.dev/vakitler/9541

İletişim

Aşağıdaki mail adresinden bizimle iletişim kurabilirsiniz.