İçeriğe geç

Kuran Galerisi Geliştiriciler

Ücretsiz Namaz Vakitleri API'si: Anahtar Yok

Dört herkese açık uç nokta namaz vakitlerini JSON olarak, takvim akışını, şehir aramayı ve yakındaki camileri döndürür. Hesap yok, API anahtarı yok, ücret yok.

API anahtarı yokJSON ve iCalÜcretsiz

Temel URL

https://qurangallery.com/prayer

Aşağıdaki tüm uç noktalar bu adresin altındadır. Hatalı girdi 400, çok fazla istek 429 döndürür. API CORS başlığı göndermez; bu yüzden başka bir sitedeki tarayıcı sayfasından değil, sunucunuzdan çağırın.

Bir konum için namaz vakitleri

GET /prayer/api/times

Bir koordinat çifti için bugünün imsak, güneş, öğle, ikindi, akşam ve yatsı vakitleri ile yarının imsağı. Her vakit UTC cinsinden ISO 8601 anıdır. O enlemde o gün bulunmayan bir vakit yanıta konmaz.

Parametreler

lat zorunlu
Ondalık derece cinsinden enlem.
lng zorunlu
Ondalık derece cinsinden boylam.
method isteğe bağlı
Hesaplama yöntemi kimliği, örneğin muslim-world-league, north-america veya karachi. Varsayılan: en yakın şehrin yöntemi.
madhab isteğe bağlı
İkindi vaktini belirleyen Hanafi veya Shafi. Varsayılan: en yakın şehrin ülkesindeki yaygın uygulama.
hlr isteğe bağlı
Yüksek enlem kuralı: auto, middle-of-the-night, seventh-of-the-night veya twilight-angle. Varsayılan: auto.
fa isteğe bağlı
Özel sabah namazı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.
ia isteğe bağlı
Özel yatsı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.

Örnek

curl
curl 'https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262'
fetch
const res = await fetch('https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262');
const { date, times, fajrTomorrow } = await res.json();

Yanıt

{
  "date": "2026-10-31",
  "times": [
    { "name": "fajr", "time": "2026-10-31T02:06:00.000Z", "isCurrent": false, "isNext": true },
    { "name": "sunrise", "time": "2026-10-31T03:23:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "dhuhr", "time": "2026-10-31T09:04:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "asr", "time": "2026-10-31T12:20:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "maghrib", "time": "2026-10-31T14:45:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "isha", "time": "2026-10-31T16:15:00.000Z", "isCurrent": false, "isNext": false }
  ],
  "fajrTomorrow": "2026-11-01T02:06:00.000Z"
}

Takvim akışı (iCal)

GET /prayer/api/calendar/feed.ics

Varsayılan olarak önümüzdeki ayın, months parametresiyle 12 aya kadar namaz vakitlerini ve İslami günleri içeren abone olunabilir .ics akışı. URL'yi Google Takvim, Apple Takvim veya Outlook'ta takvim aboneliği olarak ekleyin.

Parametreler

lat zorunlu
Ondalık derece cinsinden enlem.
lng zorunlu
Ondalık derece cinsinden boylam.
method isteğe bağlı
Hesaplama yöntemi kimliği, örneğin muslim-world-league, north-america veya karachi. Varsayılan: en yakın şehrin yöntemi.
madhab isteğe bağlı
İkindi vaktini belirleyen Hanafi veya Shafi. Varsayılan: en yakın şehrin ülkesindeki yaygın uygulama.
authority isteğe bağlı
Etkinlikler için hicri takvim otoritesi, örneğin umm_al_qura veya diyanet. Varsayılan: en yakın şehrin ülkesinin otoritesi.
months isteğe bağlı
Akışın kapsadığı ay sayısı, 1 ile 12 arası. Varsayılan: 1.
alarm isteğe bağlı
Hatırlatmanın her namazdan kaç dakika önce çalacağı, 0 ile 120 arası. 0 alarm yok demektir. Varsayılan: 10.
a_<prayer> isteğe bağlı
Tek bir namaz için alarm dakikası, 0 ile 120 arası; alarm değerinin yerine geçer. <prayer> yerine fajr, dhuhr, asr, maghrib veya isha yazın, örneğin a_fajr=15.
o_<prayer> isteğe bağlı
Bir namazı bu kadar dakika kaydırır, -60 ile 60 arası. <prayer> yerine fajr, dhuhr, asr, maghrib veya isha yazın, örneğin o_isha=5. Varsayılan: 0.
sunrise isteğe bağlı
Akışa güneş doğuşunu eklemek için 1 yazın. Varsayılan: kapalı.
travel isteğe bağlı
Yolculukta öğle, ikindi ve yatsının 2 rekata indirildiği notunu eklemek için 1 yazın. Varsayılan: kapalı.
ramadan isteğe bağlı
Ramazan günlerine Sahur bitişi (Fecr'de), İftar (Akşam'da) ve Teravih (yatsıdan 15 dakika sonra, bir saat) eklemek için 1 yapın. Günler authority parametresine göre belirlenir. Varsayılan: kapalı.
jumuah isteğe bağlı
Cuma günü öğle etkinliğinin adını “Cuma” yapmak için 1 yapın. Varsayılan: kapalı.
jumuahLead isteğe bağlı
Cuma hatırlatıcısının kaç dakika önce çalacağı, 0 ile 120 arası; 0 hatırlatıcı yok demektir. Cuma günü öğle hatırlatıcısının yerine geçer ve jumuah=1 gerektirir. Varsayılan: öğle hatırlatıcısı.
busy isteğe bağlı
Namaz etkinliklerini meşgul işaretlemek için 1 yapın (TRANSP:OPAQUE). Varsayılan: boş (TRANSP:TRANSPARENT).
hlr isteğe bağlı
Yüksek enlem kuralı: auto, middle-of-the-night, seventh-of-the-night veya twilight-angle. Varsayılan: auto.
fa isteğe bağlı
Özel sabah namazı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.
ia isteğe bağlı
Özel yatsı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.

Örnek

curl
curl 'https://qurangallery.com/prayer/api/calendar/feed.ics?lat=21.4225&lng=39.8262'

Yanıt

Varsayılan olarak bir aylık, months ile 12 aya kadar etkinlik içeren bir text/calendar (iCalendar) belgesi.

GET /prayer/api/location/search

Bir yer adını koordinata, ülke koduna ve saat dilimine çevirir. Önce kendi şehir listemizde arar. Eşleşmeyen sorgu boş bir dizi döndürür.

Parametreler

q zorunlu
Yer adı, en fazla 200 karakter.

Örnek

curl
curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'
fetch
const res = await fetch('https://qurangallery.com/prayer/api/location/search?q=Makkah');
const places = await res.json();

Yanıt

[
  {
    "lat": 21.4266,
    "lon": 39.8256,
    "displayName": "Makkah, Saudi Arabia",
    "countryCode": "SA",
    "timezone": "Asia/Riyadh"
  }
]

Yakındaki camiler

GET /prayer/api/mosques/nearby

Bir noktanın çevresindeki camiler, en yakından başlayarak, OpenStreetMap verisinden. Mesafe metre cinsindendir. Harita verisi hizmetleri kullanılamazsa yanıt 503 olur.

Parametreler

lat zorunlu
Ondalık derece cinsinden enlem.
lng zorunlu
Ondalık derece cinsinden boylam.
radius isteğe bağlı
Metre cinsinden arama yarıçapı, 100 ile 50000 arası. Varsayılan: 2000.

Örnek

curl
curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'
fetch
const res = await fetch('https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000');
const mosques = await res.json();

Yanıt

[
  {
    "id": 1234567,
    "name": "Example Mosque",
    "lat": 21.4231,
    "lng": 39.8269,
    "address": "Example Street 12",
    "distance": 96.4
  }
]

İstek sınırları

Sınırlar, bir dakikalık pencerede IP adresi başına istekleri sayar. Sınır aşılınca HTTP 429 alırsınız.

  • Namaz vakitleri: kendine ait bir sınır yok. Her sayfa görüntülemesinde çağırmak yerine her konumun yanıtını gün boyunca önbelleğe alın.
  • Takvim akışı: dakikada 30 istek.
  • Şehir arama ve yakındaki camiler tek bir hakkı paylaşır: dakikada 30 istek.

Sıkça Sorulan Sorular

Namaz vakitleri API'si ücretsiz mi, API anahtarı gerekir mi?

Evet, ücretsizdir; anahtar, hesap veya kayıt gerekmez. Yukarıdaki parametrelerle uç noktaya bir GET isteği gönderin. Lütfen istek sınırlarına uyun ve sonuçları önbelleğe alın.

Şehir adından namaz vakitlerini nasıl alırım?

Şehir arama uç noktasını q ile çağırın, ilk sonucun lat ve lon değerlerini alın, sonra bunları lat ve lng olarak namaz vakitleri uç noktasına verin.

API varsayılan olarak hangi hesaplama yöntemini ve ikindi kuralını kullanır?

method göndermezseniz koordinatlarınıza en yakın şehrin yöntemi kullanılır. madhab göndermezseniz o şehrin ülkesindeki yaygın ikindi uygulaması kullanılır. İkisini sabitlemek için method ve madhab gönderin.

Yanıttan neden bir namaz eksik?

Yazın veya kışın kutuplara yakın yerlerde güneş imsak ya da yatsı açısına hiç ulaşmayabilir; verilecek bir vakit olmaz. API geçersiz tarih döndürmek yerine o namazı yanıttan çıkarır.

API'yi tarayıcıda JavaScript ile çağırabilir miyim?

API CORS başlığı göndermez; bu yüzden başka bir sitedeki sayfa yanıtı okuyamaz. Sunucunuzdan çağırın ya da kod gerektirmeyen gömülebilir widget'ı kullanın.

Namaz vakitlerini ne sıklıkla istemeliyim?

Konum başına günde bir kez yeterlidir. Yanıtı saklayın ve geri sayımı kendi kodunuzda hesaplayın. Yatsıdan sonraki saatler için yarının imsağı da yanıtta gelir.

Namaz vakitlerini takvim uygulamasına nasıl eklerim?

Koordinatlarınızla takvim akışı URL'sine abone olun. Google, Apple ve Outlook takvimleri onu kendi takvimlerine göre yeniler ve önümüzdeki 30 günü kapsar.

Geliştiriciler

Kod yok mu? Widget'ı yerleştirin

Sitenizde bir şehrin namaz vakitlerini veya aylık takvimi 7 dilde göstermek için tek bir iframe yapıştırın. Bunun için de anahtar gerekmez.