İçeriğe geç

Ücretsiz namaz vakitleri API'si, API anahtarı gerekmez

Anahtar veya kayıt gerektirmeyen ücretsiz namaz vakitleri API'si. Günlük vakitler enlem ve boylamla JSON olarak; iCal akışı, şehir arama, yakın camiler.

Bu sayfada

qurangallery.com/prayer/developers adresindeki namaz vakitleri API’si ücretsizdir; API anahtarı veya kayıt gerektirmez. Dört herkese açık uç nokta; bir enlem ve boylam için günlük namaz vakitlerini JSON olarak, abone olunabilir bir iCal akışını, şehir aramayı ve yakındaki camileri döndürür.

Tüm uç noktalar https://qurangallery.com/prayer altındadır. Hatalı girdi 400, çok fazla istek 429 döndürür.

Bir konum için namaz vakitleri

GET /api/times, bir koordinat çifti için bugünün sabah (fecr), güneş, öğle, ikindi, akşam ve yatsı vakitlerini ve yarının sabah namazını döndürür. Her vakit UTC cinsinden ISO 8601 anıdır. O enlemde o gün bulunmayan bir vakit çıkarılır.

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

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 mwl, isna veya karachi. Varsayılan: en yakın şehrin yöntemi.
  • asr — isteğe bağlı. İkindi vaktini belirleyen standard veya hanafi. 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 ve ia — isteğe bağlı. Derece cinsinden özel sabah ve yatsı açısı, 10 ile 25 arası. Varsayılan: yöntemin kendi açısı.

Yanıt, kısaltılmış hâliyle:

{
  "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"
}

Tarih, koordinatların kendi yerel günüdür. Namaz vakitlerinin ayrı bir sınırı yoktur; bu yüzden her sayfa görüntülemesinde çağırmak yerine her konumun yanıtını gün boyunca önbelleğe alın.

Şehir arama

GET /api/location/search, bir yer adını koordinata, ülke koduna ve saat dilimine çevirir. Önce uygulamanın kendi şehir listesinde arar; eşleşmeyen sorgu boş bir dizi döndürür.

curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'
  • q — zorunlu. Yer adı, en fazla 200 karakter.
[
  {
    "lat": 21.4266,
    "lon": 39.8256,
    "displayName": "Makkah, Saudi Arabia",
    "countryCode": "SA",
    "timezone": "Asia/Riyadh"
  }
]

İlk sonucun lat ve lon değerlerini alın, sonra bunları lat ve lng olarak namaz vakitleri uç noktasına verin.

Takvim akışı (iCal)

GET /api/calendar/feed.ics, namaz vakitlerini ve İslami günleri içeren, abone olunabilir bir text/calendar dosyası döndürür; varsayılan olarak bir ay, en fazla 12 ay. URL’sini Google Takvim, Apple Takvim veya Outlook’ta bir takvim aboneliği olarak ekleyin.

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

Zorunlu: lat ve lng. İsteğe bağlı: yukarıdaki gibi method, asr, hlr, fa, ia; ayrıca:

  • authority — etkinlikler için Hicri takvim otoritesi, örneğin umm_al_qura veya diyanet. Varsayılan: en yakın şehrin ülkesinin otoritesi.
  • months — akışın kapsadığı ay sayısı, 1 ile 12 arası. Varsayılan: 1.
  • alarm — hatırlatma için her namazdan kaç dakika önce, 0 ile 120 arası. 0 alarm yok demektir. Varsayılan: 10.
  • sunrise, travel, ramadan, jumuah, busy — güneş doğuşunu, seyahat notunu, Ramazan etkinliklerini, cuma günleri Cuma’yı veya meşgul zamanı açmak için 1 yapın. Varsayılan: kapalı.

Aynı akışı kodsuz olarak takvim eşitleme sayfasında da oluşturabilirsiniz. Takvim akışı dakikada 30 isteğe izin verir.

Yakındaki camiler

GET /api/mosques/nearby, bir noktanın çevresindeki camileri, en yakından başlayarak, OpenStreetMap verisinden listeler. Mesafe metre cinsindendir. Harita verisi hizmetleri kullanılamazsa yanıt 503’tür.

curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'
  • lat ve lng — zorunlu.
  • radius — isteğe bağlı. Metre cinsinden arama yarıçapı, 100 ile 50000 arası. Varsayılan: 2000.
[
  {
    "id": 1234567,
    "name": "Example Mosque",
    "lat": 21.4231,
    "lng": 39.8269,
    "address": "Example Street 12",
    "distance": 96.4
  }
]

Kapsam OpenStreetMap’e bağlıdır. Aynı verinin uygulama içindeki görünümü camiler sayfasında anlatılır.

İ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.
  • Takvim akışı: dakikada 30 istek.
  • Şehir arama ve yakındaki camiler tek bir hakkı paylaşır: dakikada 30 istek.

Tarayıcıdan kullanma

API CORS başlığı göndermez; bu yüzden başka bir sitedeki sayfa yanıtı okuyamaz. Bunun yerine sunucunuzdan çağırın. Vakitleri yalnızca bir web sitesinde göstermek istiyorsanız web sitesi widget’ını kullanın: tek bir iframe, kod ve anahtar yok.

Ayrıca bakın

Sonraki adımlar

Sorular

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

Evet, ücretsizdir; anahtar, hesap veya kayıt gerekmez. Parametrelerle uç noktaya bir GET isteği gönderin ve istek sınırlarının içinde kalın.

Bir şehir adı için 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. asr göndermezseniz o şehrin ülkesindeki yaygın ikindi uygulaması kullanılır. Sabitlemek için ikisini de gönderin.

Yanıttan neden bir namaz eksik?

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.

İstek sınırları nedir?

Sınırlar, bir dakikalık pencerede IP adresi başına istekleri sayar. Takvim akışı dakikada 30 isteğe izin verir; şehir arama ve yakındaki camiler dakikada 30'luk tek bir hakkı paylaşır. Sınır aşılınca HTTP 429 alırsınız.

Namaz vakitlerini ne sıklıkla istemeliyim?

Konum başına günde bir kez yeterlidir. Yanıtı saklayın ve geri sayımı kendiniz hesaplayın; yatsıdan sonraki saatler için yarının sabah namazı da yanıtta gelir.

iCal akışı var mı?

Evet. Takvim akışı, namaz vakitlerini ve İslami günleri içeren abone olunabilir bir .ics dosyası döndürür; varsayılan olarak bir ay, months parametresiyle 12 aya kadar.

Bu sayfayı GitHub'da düzenle