Veriler, doğrudan platformdan
Sitenin kendi sayfalarının okuduğu katmanın aynısı. Anahtar yok, kayıt yok; HTTP üzerinden JSON. Her yanıt hangi kaynaktan geldiğini, hangi zamana ait olduğunu ve ne kadar taze olduğunu söyler.
Elektrik sistemi, gerçek zamanlı
Talep, kaynağa göre üretim ve sınır ötesi alışverişler; iletim operatörlerinin yayımladığı şekliyle. Açık.
| Adres | Ne döndürür | Sıklık |
|---|---|---|
/api/v1/countries |
Platformdaki tüm ülkeler, bölgeleri ve kapsam durumlarıyla. | Nadiren değişir — kayıt değiştiğinde. |
/api/v1/countries/:iso2/latest |
Bir ülkenin anlık görüntüsü: talep, kaynağa göre üretim, sınır dengesi. | Operatörü ne sıklıkta yayımlıyorsa — 10 saniyeden bir saate kadar. |
/api/v1/countries/:iso2/history |
Bir ülke için, seçilen aralıkta zaman serisi. | Anlık görüntüyle aynı sıklık. |
/api/v1/europe/latest |
Avrupa toplamı ve ona dahil olan her ülke. | Bir dakika. |
/api/v1/status |
Veri toplama durumu: en son hangi kaynak yayımladı ve ne zaman. | Sürekli. |
/api/v1/licenses |
Platformun her kaynağın verileriyle neler yapmasına izin verildiği. | Bir kaynağın koşulları değiştiğinde. |
/api/v1/search |
Ülkeler, bölgeler ve terimler arasında arama. | Sürekli. |
Gün öncesi piyasası
Ertesi gün için ihalede oluşan fiyatlar, teklif bölgesine göre. Şimdilik kapalı — nedenini aşağıda bulabilirsiniz.
| Adres | Ne döndürür | Sıklık |
|---|---|---|
/api/v1/prices/latest451 · lisans |
Her bölge için bilinen en son fiyat. | Günde bir kez, ihaleden sonra. |
/api/v1/prices/zones451 · lisans |
Teklif bölgeleri, her birinin saat dilimi ve para birimiyle. | Nadiren değişir. |
/api/v1/prices/date451 · lisans |
Seçilen bir teslim günü için tüm bölgeler. | Günlük. |
/api/v1/prices/country/:iso2451 · lisans |
Bir ülkenin fiyatları, her bölgesi için. | Günlük. |
/api/v1/prices/:zone/history451 · lisans |
Bir bölgenin geçmişi, aralık aralık. | Günlük. |
/api/v1/prices/:zone/summary451 · lisans |
Güne, haftaya ya da aya göre ortalama, minimum, maksimum ve kantiller. | Günlük. |
/api/v1/market/cheapest451 · lisans |
Günün en düşük ortalama fiyatına sahip bölgeler. | Günlük. |
/api/v1/market/expensive451 · lisans |
Günün en yüksek ortalama fiyatına sahip bölgeler. | Günlük. |
/api/v1/market/spreads451 · lisans |
Bölgeye göre en ucuz ve en pahalı saat arasındaki fark. | Günlük. |
/api/v1/market/cheapest-window451 · lisans |
Bir bölgede en ucuz kesintisiz N saatlik zaman aralığı. | Günlük. |
/api/v1/market/weekly451 · lisans |
Hafta kapandıktan sonra haftalık rapor. | Haftalık. |
Fiyat uç noktaları neden 451 ile yanıt veriyor
Piyasa verileri ENTSO-E şeffaflık platformundan gelir. Bunları toplar ve sitede her rakamın yanına kaynağı yazarak gösteririz; ancak bir API aracılığıyla yeniden dağıtmak, görüntülemekle aynı şey değildir ve yeniden kullanım koşulları henüz tarafımızca doğrulanıp kayda geçirilmemiştir.
O zamana kadar fiyat uç noktaları, dağıtma hakkımız olmayan bir şeyi sessizce dağıtmak yerine 451 döndürür — “yasal nedenlerle kullanılamıyor” anlamına gelen kod. Lisans sistemi ülke başına değil kaynak başına çalışır; bu yüzden bu uç noktaları açmak herhangi bir kod değişikliği gerektirmez.
İyi davranış kuralları
İstek sınırı yok ve bir sınıra gerek kalmamasını isteriz. Yanıtlar cache-control taşır: buna uyarsanız iki kez sormadan tam olarak aynı rakamları alırsınız. Gerçek zamanlı veriler, operatörün yayımladığından daha sık değişmez — saatlik yayımlayan bir ülke için saniyede bir istek yeni hiçbir şey getirmez.
Verileri kamuya açık olarak kullanırsanız bizim adımızı değil, özgün kaynağı (iletim operatörünü ya da ENTSO-E’yi) belirtin: biz verileri taşırız, üretmeyiz.
Ayrıca bakın: Veri kaynakları · Yöntem · Sistem durumu · llms.txt