API

Once sehri bulun, sonra tum zaman paketini isteyin.

SunriseTime API once sehir sluglarini bulmaniza, sonra da gunes, ay ve namaz verilerini tek bir yapili cevapta almaniza yarar. Mevcut katalog 500 indeksli sehri kapsar.

Erisim modeli

Genel beta
Su anda API anahtari gerektirmiyor
Salt-okuma entegrasyonlari ve hafif araclar icin uygun
Guncel hedef: IP basina gunde 100 istek

Urun temelleri

/api/v1/ altinda surumlenir
Her JSON cevabinda meta blogu vardir
Ucuncu taraf tarayici CORS erisimi hala sinirlidir
JSON cevaplari X-Robots-Tag: noindex gonderir

Cache politikasi

/api/v1/times: 15 dakika
/api/v1/cities: 60 dakika
/api/v1/openapi.json: 60 dakika

Hizli baslangic

Once sehir slugini bulun, sonra o slug ile zaman verisini isteyin.

1. Sehir slugini bul

curl "https://sunrisetime.co/api/v1/cities?query=istanbul&limit=3"

2. Zaman verisini cek

curl "https://sunrisetime.co/api/v1/times?city=istanbul&date=2026-03-29"

Endpointler

Bu uc endpoint cogu harici entegrasyon icin yeterlidir.

GET /api/v1/cities Sehirleri ad, slug, ulke veya bolgeye gore arayin ve sabit slug alin. GET /api/v1/times Tek bir sehir ve tarih icin gunes, altin saat, ay ve namaz verisini alin. GET /api/v1/openapi.json Uretilmis istemciler veya dahili araclar icin OpenAPI dokumanini okuyun.

Parametreler

Akisi basit tutun: once slug, sonra her istekte tek sehir.

`/api/v1/cities`

Parametre	Zorunlu	Notlar
`query`	Hayir	Sehir, slug, ulke veya idari bolge. Bos sorgu populer sehirleri dondurur.
`limit`	Hayir	Varsayilan 10, maksimum 25.

`/api/v1/times`

Parametre	Zorunlu	Notlar
`city`	Evet	istanbul, london veya tokyo gibi sabit sehir sluglari.
`date`	Hayir	Istege bagli yerel tarih, YYYY-MM-DD formatinda.

YanIt yapisi

JSON, dusuk seviyeli hesap bloklari yerine kullanim amacina gore gruplanir.

JSON

meta: surum, endpoint, dokuman URL si, cache TTL ve sorgu yansimasi
city: slug, ad, koordinatlar, saat dilimi ve nufus metadatalari
links: cozulen sehre ait site ve API URL leri
sun, goldenHour, moon ve prayerTimes bloklari

Sample response

{
  "meta": {
    "version": "v1",
    "endpoint": "/api/v1/times",
    "cacheTtlSeconds": 900
  },
  "city": {
    "slug": "istanbul",
    "name": "Istanbul",
    "timezone": "Europe/Istanbul"
  },
  "sun": {
    "sunrise": "6:43 AM",
    "sunset": "7:22 PM"
  },
  "moon": {
    "phase": "Waxing Crescent",
    "illumination": 12
  },
  "prayerTimes": {
    "fajr": "5:08 AM",
    "maghrib": "7:23 PM"
  }
}

Entegrasyon ornekleri

Simdilik komut satiri ve sunucu tarafli kullanim en iyi sonuc verir. Ucuncu taraf tarayici erisimi daha genis CORS kurallarini beklemelidir.

cURL

curl "https://sunrisetime.co/api/v1/times?city=istanbul&date=2026-03-29"

JavaScript

const cityLookup = await fetch("https://sunrisetime.co/api/v1/cities?query=istanbul&limit=1");
const cityResult = await cityLookup.json();
const citySlug = cityResult.cities[0]?.slug;

const timingResponse = await fetch(`https://sunrisetime.co/api/v1/times?city=${citySlug}&date=2026-03-29`
);
const timingData = await timingResponse.json();

console.log(timingData.sun.sunrise, timingData.prayerTimes.maghrib);

Hata modeli

Hatalar yapili JSON olarak doner; bu da dis sistemlerde daha öngorulebilir bir kullanim saglar.

Kod	Durum	Anlam
`missing_city`	400	/api/v1/times isteginde city parametresi gonderilmedi.
`invalid_date`	400	date degeri YYYY-MM-DD formatinda degildi.
`unknown_city`	404	Gonderilen sehir slugi mevcut indekste yok.
`invalid_limit`	400	/api/v1/cities istegindeki limit degeri gecersizdi.

Sonraki adimlar

Yontemi dogrulamak, sluglari incelemek veya daha yuksek kullanim istemek icin bu baglantilari kullanin.

Metodoloji Yanit bloklarinin arkasindaki gunes, ay ve namaz varsayimlarini inceleyin. Sehir dizini Sluglari elle kontrol etmek isterseniz genel sehir dizinine bakin. Iletisim Daha yuksek kullanim veya ozel entegrasyon mu gerekiyor? hello@sunrisetime.co adresine yazin.