REST API

VakitBul API v1

REST API ile namaz vakitlerini uygulamanıza entegre edin. Ücretsiz plan ile günde 100 istek yapabilirsiniz.

Base URL

https://vakitbul.com/api/v1

Kimlik Doğrulama

API key'inizi X-API-Key header'ı ile gönderin.

curl -H "X-API-Key: vb_YOUR_API_KEY" \
  https://vakitbul.com/api/v1/praytimes?city=istanbul

Rate Limit

Plan	Günlük Limit	Fiyat
Free	5 istek/gün	Ücretsiz
Premium	10,000 istek/gün	İletişime geçin

Response header'larında kalan istek sayısı: X-RateLimit-Remaining

GET /api/v1/praytimes

Belirtilen şehir ve tarih için namaz vakitlerini döndürür.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
city	string\|int	Evet	Şehir slug veya ID
date	YYYY-MM-DD	Hayır	Başlangıç tarihi (varsayılan: bugün)
days	int (1-30)	Hayır	Kaç günlük veri (varsayılan: 1)

Örnek İstek

curl "https://vakitbul.com/api/v1/praytimes?city=istanbul&date=2026-02-16&days=7"

Örnek Yanıt

{
  "success": true,
  "data": {
    "city": { "id": 1, "name": "İstanbul", "slug": "istanbul", "lat": 41.008, "lon": 28.978, "timezone": "Europe/Istanbul" },
    "times": [
      { "date": "2026-02-16", "hijri_date": "22 Recep 1447", "day_of_week": "Pazartesi", "imsak": "06:22", "gunes": "07:48", "ogle": "13:15", "ikindi": "16:05", "aksam": "18:32", "yatsi": "20:05" }
    ],
    "source": "diyanet",
    "generated_at": "2026-02-16T10:30:00+03:00"
  }
}

GET /api/v1/next

Sonraki namaz vaktini ve kalan süreyi döndürür.

curl "https://vakitbul.com/api/v1/next?city=istanbul"

{
  "success": true,
  "data": {
    "city": "İstanbul",
    "next_prayer": { "name": "İkindi", "name_en": "asr", "time": "16:05", "timestamp": 1739710800, "remaining": { "hours": 2, "minutes": 15, "seconds": 30, "total_seconds": 8130 } },
    "all_today": { "imsak": "06:22", "gunes": "07:48", "ogle": "13:15", "ikindi": "16:05", "aksam": "18:32", "yatsi": "20:05" },
    "server_time": "2026-02-16T13:49:30+03:00"
  }
}

GET /api/v1/countdown

Belirtilen vakit türü için geri sayım bilgisi döndürür.

Parametre	Tip	Açıklama
city	string\|int	Şehir slug veya ID (zorunlu)
type	string	next_prayer \| iftar \| sahur \| imsak

curl "https://vakitbul.com/api/v1/countdown?city=istanbul&type=iftar"

Hata Kodları

HTTP	Kod	Açıklama
400	INVALID_PARAM	Geçersiz veya eksik parametre
401	UNAUTHORIZED	Geçersiz veya eksik API key
404	NOT_FOUND	Şehir veya veri bulunamadı
429	RATE_LIMIT	Günlük istek limiti aşıldı
500	SERVER_ERROR	Sunucu hatası