PROGNOZY.PL / API I RSS

Dane do Twoich projektów.

Publiczne odczyty, jawne jednostki i wyraźnie oznaczone braki.

PUBLICZNE ODCZYTY · WERSJA 1

Jeden zestaw. JSON albo RSS.

Przegląd obejmuje sześć walut, trzy paliwa, pełny odczyt CPI i pogodę dla jednej z 20 miejscowości. Żądanie czyta zapisane dane serwisu; nie uruchamia importu ani modelu. Konto i klucz API nie są wymagane.

GET https://prognozy.pl/api/v1/summary?city=szczecin
GET https://prognozy.pl/api/v1/summary?city=szczecin&format=rss

Otwórz JSON Otwórz RSS Zobacz przegląd →

Parametry i odpowiedź

Pole	Znaczenie
`city`	Identyfikator miejscowości. Domyślnie `szczecin`; zmienia tylko część pogodową.
`format`	`json` (domyślnie) albo `rss`. Nieznane i powtórzone parametry są odrzucane.
`schemaVersion`	Łańcuch `"1"`. Odbiorca powinien tolerować dodatkowe pola; niezgodne zmiany otrzymają nową wersję adresu.
`generatedAt`	Czas zestawienia w UTC, nie czas publikacji źródła. Odpowiedź może być przechowywana w pamięci podręcznej przez 60 sekund.
`status`	Cały zestaw: `current` albo `partial`. Sekcje dodatkowo mogą mieć `stale` albo `missing`.
`sections[]`	11 sekcji z polami `id, kind, category, title, text, status, link, source, metrics`. Nie zawierają profili ani prywatnych prognoz użytkowników.
`source`	`name, url, asOf, recordedAt, version`: dostawca, odsyłacz do źródła, data odczytu lub wydania, czas zachowania i identyfikator zapisu. Dla CPI `asOf` ma postać YYYY-MM-01 i oznacza miesiąc; nie jest datą publikacji.

Identyfikatory 20 miejscowości

szczecin — Szczecin
warszawa — Warszawa
krakow — Kraków
wroclaw — Wrocław
gdansk — Gdańsk
poznan — Poznań
lodz — Łódź
bialystok — Białystok
swinoujscie — Świnoujście
koszalin — Koszalin
leba — Łeba
torun — Toruń
gorzow-wielkopolski — Gorzów Wielkopolski
zielona-gora — Zielona Góra
lublin — Lublin (stacja Lublin–Radawiec)
rzeszow — Rzeszów (stacja Rzeszów–Jasionka)
katowice — Katowice
opole — Opole
kielce — Kielce
zakopane — Zakopane

Liczby, daty i braki

W JSON liczby mają kropkę dziesiętną. null oznacza brak wyniku, nigdy zero. previousDate wskazuje poprzednią publikację. Pole change jest różnicą względem previousValue, a dla walut zmianą względną w procentach.

Kategoria	Wartość	Zmiana	Limit świeżości
Waluty NBP	PLN za 1 jednostkę waluty	%	5 dni od daty tabeli
Paliwa KE	PLN/l, średnia krajowa z podatkami	PLN/l	11 dni od daty odczytu
CPI GUS	% rok do roku, pełny odczyt	Punkty procentowe (`p.p.`)	80 dni od początku miesiąca odczytu
Pogoda DWD	°C, mm, km/h	Brak porównania z poprzednim wydaniem	18 godzin od wydania

Odczyty z przyszłą datą nie otrzymują statusu aktualnego. Wydanie prognozy pogodowej ma tolerancję zegara 60 sekund. Status aktualny oznacza jedynie spełnienie limitu; import może nie zawierać najnowszej publikacji dostawcy.

Dla pogody windowStart jest najbliższą pełną godziną UTC, a windowEnd następuje 24 godziny później. Opady sumujemy dla 24 przedziałów godzinowych kończących się po początku okna, aż do jego końca. Temperatury to minimum i maksimum z tych 24 punktów, a nie gwarantowane dobowe ekstrema. Dla każdej miary wymagamy kompletu 24 wartości; przy luce zwracamy null, także dla opadów. Pola: temperatureMin, temperatureMax, rainTotal, gustMax, completeHours, expectedHours.

Użycie i błędy

200 — zestaw dostępny, także częściowo; 400 — nieprawidłowe parametry; 503 — brak wszystkich danych lub problem odczytu. Błąd ma postać {"error":"opis"}. Obsługiwany jest odczyt GET. Publiczny adres zezwala na odczyt z innej domeny (CORS) bez danych uwierzytelniających.

Odpytuj nie częściej niż raz na minutę, a kanał RSS raz na godzinę. To zalecenia, nie obietnica dostępności ani stałego limitu usługi. Przy 503 odczekaj przynajmniej 60 sekund. Nie przesyłaj kluczy ani haseł w adresie.

RSS zawiera bieżące zestawienie własnych opisów liczb, nie pełne archiwum ani przedruki artykułów. GUID zmienia się wraz z zapisem źródłowym lub zakresem danych; czas pubDate oznacza zachowanie danych w serwisie. Sekcje bez danych są pomijane. Pobieranie API nie przenosi praw do materiałów dostawców; zachowaj oznaczenia źródeł i sprawdź ich zasady przed dalszą publikacją.

Pozostałe publiczne odczyty

Istniejące interfejsy pozostają bez numeru wersji; ich szczegółowy format może się zmieniać. Nowe integracje przeglądu kieruj na /api/v1/summary.

/api/markets — 10 ostatnich odczytów rynkowych.
/api/weather?city=szczecin — prognoza godzinowa dla miejscowości.
/api/calendar — kalendarz CPI; eksport ICS.
/api/community/league?kind=fx — dobrowolna Liga użytkowników; kategorie fx, weather, cpi.