Przejdź do głównej zawartości

Przegląd endpointów API

Ta strona to ręcznie pisany przewodnik po trzech podstawowych endpointach SENS Energy Data API. Nie jest to pełna specyfikacja — wiążący, wyczerpujący schemat (wszystkie pola, typy, kody błędów) zawsze znajdziesz w Swagger UI pod api.getsens.energy/api/docs.

Bazowy URL: https://api.getsens.energy. Każde zapytanie wymaga nagłówka X-API-KEY — zobacz Uwierzytelnianie.

GET /api/v1/prices​

Główny, złożony endpoint cenowy. Zwraca ceny energii elektrycznej łączące składniki dystrybucji (OSD) i sprzedaży (sprzedawca) dla wskazanej taryfy, opcjonalnie przeliczone dla konkretnego wolumenu rocznego zużycia.

Najważniejsze parametry: osd, sprzedawca, taryfa, market, date, annual_kwh, region, page, size (paginacja stosuje się w trybie przeglądowym, gdy nie podano konkretnej pary OSD/sprzedawca). Zobacz też zapytania różnicowe dla parametru since.

curl -s "https://api.getsens.energy/api/v1/prices?osd=tauron&taryfa=G11" \
  -H "X-API-KEY: $SENS_API_KEY"

GET /api/v1/tariffs​

Katalog taryf zatwierdzonych przez URE — identyfikator taryfy, operator, typ (dystrybucja/sprzedaż), grupa taryfowa, liczba stref, poziom napięcia, region, okres obowiązywania. Wspiera paginację (page, size, maks. 1000) i filtrowanie różnicowe przez since/If-Modified-Since.

curl -s "https://api.getsens.energy/api/v1/tariffs?size=50" \
  -H "X-API-KEY: $SENS_API_KEY"

GET /api/v1/tariffs/components​

Rozbicie pojedynczej taryfy (tariff_id) na poszczególne składniki cenowe — nazwa, kategoria, wartość, jednostka, waluta, strefa. Przydatne, gdy potrzebujesz pełnej struktury opłat zamiast zagregowanej sumy z /prices.

curl -s "https://api.getsens.energy/api/v1/tariffs/components?tariff_id=TAURON_G11_2026" \
  -H "X-API-KEY: $SENS_API_KEY"

Co dalej​