dolulukorani.com
Açık VeriCC BY 4.0

Baraj Doluluk Verisi: API ve CSV

dolulukorani.com'un derlediği baraj doluluk verisi ücretsizdir. Haberlerde, araştırmalarda ve uygulamalarda kullanabilirsiniz; tek koşul atıftır. Veri her gün yaklaşık 10:00 ve 22:00'de resmi kaynaklardan yenilenir.

Hızlı İndirme (CSV)

Her il ve baraj sayfasındaki grafiğin altında o sayfanın CSV bağlantısı bulunur. CSV UTF-8 kodludur, ayırıcı virgül, ondalık ayırıcı noktadır.

Uç Noktalar

GETAçıklama
/api/v1/provinces81 ilin son doluluk oranı, ölçüm zamanı, tazelik ve 7 günlük değişim.
/api/v1/provinces/{il}Tek il ve barajları (ör. istanbul, ankara, izmir).
/api/v1/provinces/{il}/history?days=365İlin günlük doluluk serisi. days: 7–1100 veya all.
/api/v1/damsTüm barajların son ölçümü. ?province=istanbul ile il süzgeci.
/api/v1/dams/{baraj}Tek baraj: kapasite, hacim, son ölçüm.
/api/v1/dams/{baraj}/history?days=365Barajın gün sonu ölçümleri; varsa göl kotu ve hacim.
/api/v1/nationalDSİ resmi Türkiye geneli seri (içme suyu, sulama, enerji) ve kendi ağırlıklı ortalamamız.
/api/v1/bulletinGünlük bülten verisi ve hazır paylaşım metni.

Liste ve geçmiş uç noktaları ?format=csv ile CSV döner. Yanıtlar JSON'dur, CORS açıktır.

Alanlar

slug
İl kimliği (URL'deki ad)
fill_rate
Doluluk oranı, yüzde (ondalık ayırıcı nokta). Ölçüm yoksa boş.
measured_at
Ölçüm zamanı (ISO 8601)
freshness
today (48 saat), recent (30 gün), stale (daha eski), unknown
delta_7d
7 günlük değişim, puan. Gerçek 7 gün önceki ölçüm yoksa boş.
authority
Veriyi yayımlayan su idaresi (İSKİ, ASKİ …)

İl oranı, ölçülen içme suyu barajlarının kapasite ağırlıklı ortalamasıdır; su idaresi kendi il oranını yayımlıyorsa o kullanılır. Ayrıntı: Baraj doluluk oranı nasıl hesaplanır?

Örnekler

curl "https://www.dolulukorani.com/api/v1/provinces/istanbul/history?days=30"
curl -o iller.csv "https://www.dolulukorani.com/api/v1/provinces?format=csv"
const res = await fetch("https://www.dolulukorani.com/api/v1/provinces");
const { data, attribution } = await res.json();
const istanbul = data.find((il) => il.slug === "istanbul");
console.log(istanbul.fill_rate, attribution);

Lisans ve Atıf

Derlenmiş veri Creative Commons Atıf 4.0 (CC BY 4.0) lisansıyla sunulur. Ticari kullanım dahil serbesttir. Kullanırken şu atfı ekleyin:

Kaynak: dolulukorani.com (resmi kurum verilerinden derlenmiştir)

Ham verinin sahibi ölçümü yayımlayan kurumdur (DSİ, İSKİ, ASKİ, İZSU ve diğer su idareleri). Her il ve baraj sayfasında kaynak kurum belirtilir. Web sitesinde atıf için sayfaya bağlantı vermeniz yeterlidir.

Güncelleme ve Adil Kullanım

  • Veri her gün yaklaşık 10:00 ve 22:00'de resmi kaynaklardan çekilir.
  • Yanıtlar 30 dakika önbelleklenebilir; daha sık sorgulamaya gerek yoktur.
  • IP başına dakikada en fazla 60 istek. Aşılırsa 429 döner.
  • Ölçüm arşivimiz Nisan 2026'da başlar. Türkiye geneli DSİ serisi 2024'ten itibaren mevcuttur.
  • Kaynakların güncel durumu: Veri Durumu.

Daha yüksek kullanım, toplu arşiv veya sorun bildirimi için iletişim sayfasını kullanın. Sitenize canlı kart eklemek için Basın ve Widget sayfasına bakın.