Geliştirici API v1

Sahur Vakti namaz vakitleri API'si ücretsizdir, JSON döner ve kimlik doğrulaması gerektirmez. Site geneli ve uygulamalarınız için vakit verilerini güvenle kullanabilirsiniz. Aşağıdaki tüm uç noktalar GET metodudur ve aynı temel adresi paylaşır.

🔑 Ücretsiz API Anahtarı Al 🧩 Sitenize Widget Ekleyin

GET /api/v1/cities

Şehir listesi

Vakitlerin sunulduğu tüm aktif şehirler. Sayfalama yoktur; tek istekte tam liste döner.

Örnek istek https://sahurvakti.com//api/v1/cities

GET /api/v1/cities/{slug}

Şehir detayı

Tek bir şehrin koordinat, saat dilimi ve popülerlik bilgisi.

{slug} — Şehir slug'ı (örn. istanbul)

Örnek istek https://sahurvakti.com//api/v1/cities/istanbul

GET /api/v1/prayer-times/{slug}

Günlük vakitler

Şehrin bugünkü altı vakidi (imsak, güneş, öğle, ikindi, akşam, yatsı) HH:MM biçiminde döner.

{slug} — Şehir slug'ı

Örnek istek https://sahurvakti.com//api/v1/prayer-times/istanbul

GET /api/v1/prayer-times/{slug}/{tarih}

Tarihli vakitler

Belirli bir günün vakitleri (Y-m-d). Geçmiş ve gelecek tarihler desteklenir.

{slug} — Şehir slug'ı
{tarih} — YYYY-MM-DD

Örnek istek https://sahurvakti.com//api/v1/prayer-times/istanbul/2026-03-01

GET /api/v1/ramadan/{slug}

Ramazan özeti

Ramazan dönemi bilgisi: gün numarası, iftar/sahur ve teravih bağlamı.

{slug} — Şehir slug'ı

Örnek istek https://sahurvakti.com//api/v1/ramadan/ankara

GET /api/v1/summary/{slug}

Canlı özet (widget)

Sıradaki vakit, sahur bitişine ve iftara kalan saniye. Embed widget ve mobil uygulamalar bu ucu kullanır.

{slug} — Şehir slug'ı

Örnek istek https://sahurvakti.com//api/v1/summary/izmir

Örnek yanıt

/api/v1/summary/istanbul ucu canlı sayaç bilgisiyle birlikte günlük vakitleri tek istekte verir:

{
    "success": true,
    "city": "İstanbul",
    "slug": "istanbul",
    "date": "2026-09-26",
    "times": {
        "imsak": "04:58",
        "gunes": "06:29",
        "ogle": "13:03",
        "ikindi": "16:37",
        "aksam": "19:26",
        "yatsi": "20:50"
    },
    "next": {
        "key": "aksam",
        "time": "19:26",
        "remaining": 12840
    },
    "server_time": 1790377311
}

Limitler ve anahtar

Anahtarsız: IP başına günde 200 istek. Denemek ve küçük projeler için yeterlidir.
Anahtarlı (?key=): günde 5.000 istek, kullanım istatistikleriyle. Üye girişiyle /api/anahtar adresinden anında oluşturabilirsiniz.
Anahtarı isteğin sonuna ekleyin: https://sahurvakti.com//api/v1/summary/istanbul?key=sv_...
Limit aşımında 429, geçersiz anahtarda 401, bulunamayan şehirde 404 döner. Yanıt gövdesi her durumda JSON'dur.
Veri, Diyanet yöntemine göre astronomik hesapla üretilir ve önbelleklenir; yoğun kullanımda lütfen iletişime geçin.
API ücretsizdir; ancak servis işlevselliğini bozan kullanım (DoS benzeri istek paternleri) anahtarın kapatılmasıyla sonuçlanabilir.

Atıf: Veriyi kullanırken görünür bir yerde “Kaynak: sahurvakti.com” ibaresine ve mümkünse bağlantıya yer vermenizi rica ederiz.