Zaloguj się
DEWELOPERZY

API kalkulatora

Wbuduj wyniki kalkulatora ciepła w swoją aplikację. Dokumentacja jest publiczna, klucze API i statystyki użycia wymagają zalogowania.

Publiczne API · v1

Kalkulator ciepła jako API

Główny endpoint POST /v1/api/v1/heatcalc liczy zapotrzebowanie cieplne i klasę energetyczną budynku. Słowniki dostarczają wartości enum, jednostki i opisy potrzebne do skompletowania payload. Endpointy klimatyczne są niezależne — zwracają temperaturę projektową i strefę dla podanej lokalizacji.

Otwórz pełną dokumentację Swagger Pobierz schemat OpenAPI 3.0 (JSON)
Główny endpoint1 endpoint

Kalkulator ciepła

Synchroniczny endpoint zwracający kompletną kalkulację OZC w jednym round-tripie. Uwierzytelnij się nagłówkiem Authorization: Bearer pc_…, żeby wynik trafił na konto użytkownika i pojawił się w „Moje wyniki" z oznaczeniem Z API.

POST/v1/api/v1/heatcalc

Body i response zgodne ze schematem CreateUsersHeatcalcDto / GetUsersHeatcalcDto. Pełną strukturę zobaczysz w Swaggerze pod sekcją Calculator (public).

Słowniki — wsparcie kalkulatora25 endpointów

Dictionaries v2

Wartości enum dla pól kalkulatora: typy budynku, źródła ciepła, sprawności, klasy izolacji, ceny paliw. Pobierasz je raz, używasz do zbudowania payload dla POST /heatcalc.

  • GET /v1/dictionaries/v2/building-types
  • GET /v1/dictionaries/v2/heat-sources?country=PL
  • GET /v1/dictionaries/v2/fuel-prices
Klimat — niezależne12 endpointów

Climate v1 — Polska

Odrębna domena. Po podaniu lokalizacji (kod pocztowy, lat/lng albo miasto) zwraca temperaturę projektową, strefę PN-B-02403 i listę najbliższych stacji IMGW / Open-Meteo.

  • GET /v1/api/v1/climate/by-postal-code/{code}
  • GET /v1/api/v1/climate/by-coords?lat=&lng=
  • GET /v1/api/v1/climate/zones
Auth

Klucz API

Endpointy publiczne mają wspólny limit anonimowy. Aby zwiększyć przepustowość i powiązać wyniki z kontem, wygeneruj klucz w zakładce Klucze API i wyślij go nagłówkiem Authorization: Bearer pc_….

Szybki start — pełen flow w 3 krokach

1. Pobierz słowniki → 2. Zbuduj payload → 3. Wywołaj kalkulator. Wynik wyląduje na liście „Moje wyniki".

# 1. Lista źródeł ciepła
curl 'https://policzcieplo.pl/api/v1/dictionaries/v2/heat-sources?country=PL' \
  -H 'Authorization: Bearer pc_...'

# 2. Wywołanie kalkulatora
curl -X POST 'https://policzcieplo.pl/api/v1/v1/heatcalc' \
  -H 'Authorization: Bearer pc_...' \
  -H 'Content-Type: application/json' \
  -d @payload.json
portal działa dzięki