Zaloguj się
DEWELOPERZY

API kalkulatora

Silnik OZC i narzędzia integracyjne dla produktów grzewczych, OZE i nieruchomości.

REST API · OpenAPI 3.0

Silnik OZC gotowy do użycia w Twoim produkcie

Jedno wywołanie zwraca zapotrzebowanie cieplne, moc grzewczą, koszt ogrzewania, emisję CO2 i klasę energetyczną budynku.

Przejdź do dokumentacji Wygeneruj klucz API
POST/v1/api/v1/heatcalc
  • PN-EN 12831
  • 1 round-trip
  • Wynik JSON
Niebieska maskotka PoliczCieplo trzyma pomarańczową wtyczkę.
Jeden wynik

Komplet liczb do dalszego procesu

Synchroniczny endpoint liczy zapotrzebowanie cieplne i klasę energetyczną według metodyki PN-EN 12831.

  • Moc grzewczakW
  • Zapotrzebowanie rocznekWh/rok
  • Koszt ogrzewaniazł/rok
  • Emisja CO2t/rok
  • Klasa energetycznaA+..G
Co możesz zbudować

Jeden silnik, różne produkty

Wynik kalkulacji możesz wykorzystać w interfejsie dla klienta, procesie ofertowania albo wewnętrznym narzędziu zespołu.

  • Dobór pompy ciepłaKalkulator na stronie firmy instalacyjnej, oparty o moc grzewczą i roczne zapotrzebowanie.
  • Oferta termomodernizacjiLiczby z kalkulacji jako podstawa oferty i rozmowy o kosztach ogrzewania.
  • Wstępna klasa energetycznaWynik dla portalu nieruchomości albo narzędzia dewelopera mieszkaniowego.
  • Narzędzie doradcySzybka wycena z mocą, zużyciem, kosztem i emisją CO2 w jednym wyniku.
  • Wynik przy leadzie w CRMWłasny backend może zapisać odpowiedź JSON w CRM, bazie, arkuszu albo systemie ofertowania.
Jak to działa

Od formularza do wyniku w trzech ruchach

  1. Pobierz słownikiDictionaries v2 udostępnia 25 endpointów z wartościami dla typów budynku, źródeł ciepła, sprawności, klas izolacji i cen paliw.
  2. Zbuduj payloadUzupełnij dane budynku. Climate v1 dla Polski udostępnia 12 endpointów z temperaturą projektową, strefą PN-B-02403 i najbliższymi stacjami IMGW lub Open-Meteo.
  3. Wywołaj kalkulacjęWyślij POST z kluczem pc_... w nagłówku Authorization: Bearer. Odpowiedź wróci jako JSON.
curl -X POST https://policzcieplo.pl/api/v1/api/v1/heatcalc \
  -H "Authorization: Bearer pc_..." \
  -H "Content-Type: application/json" \
  -d @payload.json

Pełny schemat payloadu i odpowiedzi znajdziesz w Swaggerze oraz w pliku OpenAPI 3.0 JSON.

Otwórz Swagger Pobierz OpenAPI 3.0 JSON
Dane tam, gdzie ich potrzebujesz

JSON łączy kalkulację z Twoim procesem

Nie ma gotowej integracji z konkretnym CRM-em. Kalkulację pobierasz z własnego backendu, a o nowym leadzie powiadamiamy webhookiem.

  1. Formularz
  2. Twój backend
  3. PoliczCieplo API
  4. Wynik JSON
  5. CRM · baza · arkusz · oferta
Dostęp i kontrola

Klucz generujesz w panelu

Po zalogowaniu przejdź do zakładki Klucze API. Klucz ma format pc_... i wysyłasz go jako Authorization: Bearer.

Przejdź do Kluczy API
  • Wynik trafia do Moje wyniki z oznaczeniem Z API.
  • Statystyki klucza są dostępne w zakładce Użycie.
  • Bez klucza obowiązuje wspólny limit anonimowy.
  • Klucz bez aktywnego pakietu ma limit 10 kalkulacji na 7 dni.
  • Klucz z aktywnym pakietem płatnym działa bez limitu.
Wybierz drogę integracji

Nie zawsze potrzebujesz własnego API

Bez programowaniaWidget na stronęOsadź pełny kalkulator jednym snippetem HTML. Lead trafi do konta właściciela strony.Zobacz widget Płatny pakietWebhooki leadowe Gdy powstaje Twój lead, wysyłamy podpisany POST pod wskazany adres. Zdarzenie niesie identyfikatory i zgody, a szczegóły dociągasz kluczem. Skonfiguruj webhooki W przygotowaniuIntegracje AI przez MCPPlanowana droga integracji z Claude, ChatGPT i Cursor przez serwer MCP.Sprawdź status
Gotowy na pierwsze wywołanie?

Zacznij od schematu albo od klucza

Dokumentacja pokazuje endpointy, payload i odpowiedź. Po zalogowaniu wygenerujesz klucz i sprawdzisz jego użycie w panelu.

Przejdź do dokumentacji Wygeneruj klucz API
portal działa dzięki