API danych pogodowych

Ostatni odczyt każdego czujnika ze stacji głównej wraz z czasem pomiaru, jednostką i wartościami pochodnymi (kierunek wiatru słownie, stopień Beauforta).

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/current"

{
    "temp_out": {
        "value": 3.4,
        "unit": "°C",
        "name": "Temperatura",
        "measured_at": "2026-08-05T14:20:00+02:00"
    }
}

Nasza prognoza: mieszanka modeli ważona ich skutecznością na naszych pomiarach, z korektą lokalnego błędu systematycznego. Pole *_uncertainty to rozrzut między modelami — im większy, tym mniej pewna prognoza.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/forecast"

{
    "hourly": [
        {
            "time": "2026-08-05T15:00:00+02:00",
            "temp_out": 4.1,
            "temp_out_uncertainty": 0.8,
            "rain_total": 0.2
        }
    ]
}

Dane pod sterownik podlewania: opad z ostatniej doby i trzech dób, prognoza opadu na 12 i 24 h, wilgotność gleby i ewapotranspiracja. Pole skip_watering to gotowa decyzja — wstrzymujemy podlewanie przy 5 mm opadu w ostatniej dobie albo 3 mm zapowiedzianych w najbliższych 12 godzinach.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/irrigation"

{
    "rain_24h": 4.6,
    "rain_next_12h": 0,
    "rain_prob_12h": 15,
    "soil_moist": 38,
    "evapotranspiration": 3.1,
    "skip_watering": false
}

Nasłonecznienie, temperatura odczuwalna, punkt rosy i poryw wiatru wraz z gotowymi decyzjami: close_blinds (rolety przed nagrzaniem), retract_awning (markiza przed porywem) i free_cooling (przewietrzanie, gdy na zewnątrz chłodniej i sucho — liczone z punktu rosy, nie z samej temperatury).

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/building"

{
    "solar_wm2": 640,
    "temp_apparent": 4.6,
    "dew_point": 1.1,
    "wind_gust": 8.4,
    "close_blinds": true,
    "free_cooling": false
}

Decyzja o przewietrzaniu liczona z wilgotności bezwzględnej (g/m³), nie względnej — powietrze o 90% przy 5 °C jest suchsze niż o 50% przy 25 °C. Uwzględniamy też zapylenie: ventilate_now jest fałszywe przy złej jakości powietrza, nawet gdy warunki wilgotnościowe sprzyjają.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/ventilation"

{
    "humidity_abs": 4.31,
    "humidity_abs_indoor_ref": 8.16,
    "pm25": 11,
    "air_quality_ok": true,
    "ventilate_now": true,
    "heat_recovery_needed": true
}

Prognozowany szczyt doby wraz z godziną, minimum nocne, stopniodni chłodzenia i temperatura mokrego termometru. precool_recommended podpowiada wstępne schłodzenie budynku w tańszej taryfie nocnej, gdy zapowiada się upał, a noc jest na tyle chłodna, żeby dało się zmagazynować chłód.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/hvac"

{
    "wet_bulb": 19.2,
    "cdd_today": 4.1,
    "temp_peak_24h": 31.2,
    "peak_at": "2026-08-06T15:00:00+02:00",
    "night_min_24h": 16.4,
    "precool_recommended": true
}

Prognoza produkcji instalacji PV: moc chwilowa, suma na dziś i jutro, szczyt wraz z godziną oraz krzywa godzinowa. Wymaga włączonego modułu i ustawionych parametrów instalacji w panelu.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/pv"

{
    "now_kw": 4.12,
    "today_kwh": 38.6,
    "tomorrow_kwh": 41.2,
    "peak_kw": 7.08,
    "peak_at": "2026-08-06T13:00:00+02:00"
}

Ryzyko przymrozku przygruntowego na najbliższe noce (z osobną temperaturą przy gruncie), okna dogodne do oprysku, temperatura i wilgotność gleby, suma opadów od zadanej daty oraz suma temperatur efektywnych. Zwracamy też gotowe decyzje: frost_warning, cover_plants, spray_now, soil_ready_sow — sterownik nie musi niczego przeliczać.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/garden"

{
    "frost_warning": true,
    "cover_plants": false,
    "spray_now": false,
    "soil_ready_sow": true,
    "nights": [
        {
            "night": "2026-08-06",
            "air_min": 2.4,
            "ground_min": -0.8,
            "level": 1,
            "level_name": "możliwy przygruntowy"
        }
    ]
}

Dobór mocy i szacunek rocznego zużycia dla zadanych parametrów budynku, liczone z lokalnego archiwum temperatur: temperatura projektowa, stopniogodziny, SCOP ważony godzinami pracy i porównanie kosztu z innymi źródłami ciepła. Endpoint dla firm dobierających instalacje z własnego systemu ofertowego.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/heatpumpcalc"

{
    "design_temp": -18.5,
    "power_kw": 9.7,
    "recommended_kw": 10.5,
    "heat_demand_kwh": 16769,
    "electricity_kwh": 4355,
    "scop": 3.85,
    "cost_year": 4791
}

Szereg czasowy jednego czujnika. Do 8 dni zwracamy rozdzielczość godzinową, powyżej — dobową. Maksymalny zakres jednego zapytania to 366 dni.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/history"

{
    "sensor": "temp_out",
    "points": [
        {
            "time": "2026-08-04T10:00:00+02:00",
            "avg": 18.2,
            "min": 17.4,
            "max": 19.1
        }
    ]
}

Minima, średnie, maksima i sumy dla wszystkich czujników, dzień po dniu.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/daily"

{
    "2026-08-04": {
        "temp_out": {
            "min": 12.1,
            "avg": 18.4,
            "max": 24.9,
            "sum": null
        }
    }
}

Wartości skrajne wraz z datą i godziną wystąpienia.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/records"

{
    "temp_out": {
        "max": {
            "value": 36.8,
            "unit": "°C",
            "occurred_at": "2025-07-11T15:40:00+02:00"
        }
    }
}

Aktualne stężenia pyłu zawieszonego PM 2,5 i PM 10.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/air"

{
    "pm25": 8.4,
    "pm10": 14.2,
    "unit": "µg/m³"
}

Źródła danych zasilające portal wraz ze współrzędnymi i czasem ostatniego odczytu.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/stations"

[
    {
        "code": "local",
        "name": "Stacja lokalna",
        "primary": true
    }
]

Kody, nazwy i jednostki wszystkich dostępnych kanałów pomiarowych. Zacznij od tego endpointu, żeby poznać kody używane w pozostałych.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/sensors"

[
    {
        "code": "temp_out",
        "name": "Temperatura",
        "unit": "°C",
        "aggregation": "avg"
    }
]

Aktywne ostrzeżenia meteorologiczne — te same, które widać w portalu, bez powtórzeń. Pole severity: 1 żółty, 2 pomarańczowy, 3 czerwony. Ostrzeżenia wygasają automatycznie, więc pusta lista naprawdę oznacza brak zagrożeń.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/warnings"

{
    "active": true,
    "max_severity": 3,
    "count": 1,
    "items": [
        {
            "title": "Upał — stopień 3",
            "severity": 3,
            "severity_name": "czerwony",
            "valid_to": "2026-08-06T20:00:00+02:00"
        }
    ]
}

Wszystkie bieżące wartości jako jeden płaski obiekt — gotowe pod sensor typu rest w Home Assistancie, bez szablonów zagnieżdżonych.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/ha"

{
    "temp_out": 3.4,
    "hum_out": 82,
    "press_rel": 1013.2,
    "warning_active": 1,
    "warning_severity": 3,
    "warning_title": "Upał — stopień 3",
    "updated": "2026-08-05T14:20:00+02:00"
}

Zestaw przygotowany pod sterowanie ogrzewaniem: temperatura bieżąca, średnia i minimum z 24 h, prognoza na 24 h, punkt rosy, stopniodni grzewcze i flaga ryzyka przymrozku. Do krzywej grzewczej używaj temp_avg_24h — odczyt chwilowy zbyt mocno reaguje na słońce padające na czujnik i podmuchy wiatru.

curl -H "X-API-Key: TWÓJ_TOKEN" \
  "https://pogoda-wodzislaw.coreinfra.eu/api/v1/heatpump"

{
    "temp_now": 3.4,
    "temp_avg_24h": 2.8,
    "temp_min_24h": -1.2,
    "hdd_today": 12.2,
    "frost_risk_24h": true
}