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
latzorunlu- Ondalık derece cinsinden enlem.
lngzorunlu- Ondalık derece cinsinden boylam.
methodisteğ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.
madhabisteğe bağlı- İkindi vaktini belirleyen Hanafi veya Shafi. Varsayılan: en yakın şehrin ülkesindeki yaygın uygulama.
hlristeğe bağlı- Yüksek enlem kuralı: auto, middle-of-the-night, seventh-of-the-night veya twilight-angle. Varsayılan: auto.
faisteğe bağlı- Özel sabah namazı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.
iaisteğe bağlı- Özel yatsı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.
Örnek
curl 'https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262'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
latzorunlu- Ondalık derece cinsinden enlem.
lngzorunlu- Ondalık derece cinsinden boylam.
methodisteğ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.
madhabisteğe bağlı- İkindi vaktini belirleyen Hanafi veya Shafi. Varsayılan: en yakın şehrin ülkesindeki yaygın uygulama.
authorityisteğe bağlı- Etkinlikler için hicri takvim otoritesi, örneğin umm_al_qura veya diyanet. Varsayılan: en yakın şehrin ülkesinin otoritesi.
monthsisteğe bağlı- Akışın kapsadığı ay sayısı, 1 ile 12 arası. Varsayılan: 1.
alarmisteğ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.
sunriseisteğe bağlı- Akışa güneş doğuşunu eklemek için 1 yazın. Varsayılan: kapalı.
travelisteğe bağlı- Yolculukta öğle, ikindi ve yatsının 2 rekata indirildiği notunu eklemek için 1 yazın. Varsayılan: kapalı.
ramadanisteğ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ı.
jumuahisteğe bağlı- Cuma günü öğle etkinliğinin adını “Cuma” yapmak için 1 yapın. Varsayılan: kapalı.
jumuahLeadisteğ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ı.
busyisteğe bağlı- Namaz etkinliklerini meşgul işaretlemek için 1 yapın (TRANSP:OPAQUE). Varsayılan: boş (TRANSP:TRANSPARENT).
hlristeğe bağlı- Yüksek enlem kuralı: auto, middle-of-the-night, seventh-of-the-night veya twilight-angle. Varsayılan: auto.
faisteğe bağlı- Özel sabah namazı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.
iaisteğe bağlı- Özel yatsı açısı, derece olarak, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.
Örnek
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.
Şehir arama
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
qzorunlu- Yer adı, en fazla 200 karakter.
Örnek
curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'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
latzorunlu- Ondalık derece cinsinden enlem.
lngzorunlu- Ondalık derece cinsinden boylam.
radiusisteğe bağlı- Metre cinsinden arama yarıçapı, 100 ile 50000 arası. Varsayılan: 2000.
Örnek
curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'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.
