Dla programistów

1. Wstaw kalkulator na swoją stronę (iframe)

Najprostszy sposób. Nie musisz niczego pobierać ani programować. Wklej kod w miejsce na stronie, w którym ma się pojawić kalkulator (np. w edytorze HTML WordPressa, bloku „Własny HTML”, w szablonie strony).

1. 1

   Wybierz kalkulator i skopiuj kod

   Kalkulatorb2b-uopbmibrutto-nettobudzet-50-30-20budzet-osobistyfireike-ikzeinflacjakalkulator-czasukalkulator-godzinkalkulator-godzin-pracykiedy-milionkoszt-subskrypcjikoszty-samochodukupno-vs-wynajemleasing-vs-kredytlokatynadplacanieprocent-skladanyrata-kredyturentownosc-najmusplata-dlugowterwhrwynajem-porownaniezapotrzebowanie-kcalzdolnosc-kredytowazuzycie-pradu

   Wysokość początkowa (px)

   Kopiuj

   <iframe
     src="https://cyfromat.pl/embed/rata-kredytu/"
     title="rata-kredytu"
     width="100%" height="900"
     style="border:0" loading="lazy"></iframe>

2. 2

   Wklej kod na swojej stronie

   Gotowe: kalkulator pojawi się w tym miejscu, bez reklam i bez naszego nagłówka. Pod spodem jest link do Cyfromat.pl, prosimy go nie usuwać.

3. 3

   (Opcjonalnie) Dopasuj wysokość automatycznie

   Gdy kalkulator rośnie (np. po wyliczeniu tabeli), iframe domyślnie się nie powiększy. Wklej ten skrypt raz na stronie, a wysokość będzie się dopasowywać:

   Kopiuj

   <script>
     window.addEventListener("message", (e) => {
       if (e.origin !== "https://cyfromat.pl" || e.data?.type !== "cyfromat:resize") return;
       document.querySelectorAll('iframe[src*="/embed/' + e.data.slug + '/"]')
         .forEach((f) => (f.style.height = e.data.height + "px"));
     });
   </script>

Podgląd wybranego kalkulatora: /embed/rata-kredytu/. Widżety nie są indeksowane przez wyszukiwarki.

2. Policz we własnym kodzie (biblioteka JavaScript)

Dla osób, które chcą własny formularz i własny wygląd. Cyfromat nie ma serwera, który liczy za Ciebie, dlatego wzory są w pliku JavaScript, a liczenie odbywa się u Ciebie (w przeglądarce użytkownika albo w Node.js). Wyniki są takie same jak w kalkulatorach na stronie.

W przeglądarce: bez instalowania

Przeglądarka sama pobierze plik z cyfromat.pl, nic nie musisz ściągać.

<script type="module">
  import { calculate } from "https://cyfromat.pl/lib/v1/cyfromat.mjs";

  const { result } = calculate("rata-kredytu", {"loanAmount":400000,"interestRate":7.5,"loanTermYears":25,"repaymentType":"equal"});
  document.body.textContent = "Rata: " + result.monthlyPayment + " zł";   // 2956
</script>

W Node.js: pobierz plik raz

Node nie importuje plików spod adresu https://, więc plik trzeba mieć lokalnie (np. w katalogu projektu).

curl -O https://cyfromat.pl/lib/v1/cyfromat.mjs

# potem w kodzie (ESM):
import { calculate } from "./cyfromat.mjs";
const { result } = calculate("inflacja", { amount: 100000, annualInflation: 4, years: 10 });

Jakie dane podać?

Parametry każdego kalkulatora znajdziesz w katalogu (sekcja 3) lub w schemacie JSON. Błędne dane nie psują strony: funkcja zgłasza wyjątek z listą problemów.

try {
  calculate("rata-kredytu", { loanAmount: -1 });
} catch (e) {
  console.log(e.code);     // "invalid_params"
  console.log(e.details);  // ["loanAmount: minimum to 1", "interestRate: parametr wymagany", ...]
}

Kalkulatory dostępne w bibliotece

• rata-kredytu: Kalkulator rat kredytu (schemat)
• brutto-netto: Kalkulator brutto-netto (schemat)
• procent-skladany: Kalkulator procentu składanego (schemat)
• zdolnosc-kredytowa: Kalkulator zdolności kredytowej (schemat)
• budzet-50-30-20: Kalkulator budżetu 50/30/20 (schemat)
• fire: Kalkulator FIRE (schemat)
• b2b-uop: Porównanie B2B i umowy o pracę (schemat)
• inflacja: Kalkulator inflacji (schemat)
• nadplacanie: Kalkulator nadpłat kredytu (schemat)
• koszty-samochodu: Kalkulator kosztów samochodu (TCO) (schemat)
• ike-ikze: Kalkulator IKE i IKZE (schemat)
• leasing-vs-kredyt: Leasing vs kredyt (schemat)
• rentownosc-najmu: Kalkulator rentowności najmu (schemat)
• kupno-vs-wynajem: Kupno vs wynajem (schemat)
• obligacje: Kalkulator obligacji skarbowych (schemat)
• splata-dlugow: Planer spłaty długów (schemat)

3. Odczytaj listę kalkulatorów (katalog API)

Katalog to pliki JSON, które opisują kalkulatory: nazwy, parametry, zakresy, przykłady i linki. Nie zwraca wyniku obliczeń. Przydaje się, gdy chcesz automatycznie zbudować listę lub formularz. Można go otworzyć w przeglądarce albo pobrać poleceniem curl (w terminalu).

1. 1

   Pobierz listę wszystkich kalkulatorów

   Kopiuj

   curl -s https://cyfromat.pl/api/v1/calculators.json

   W odpowiedzi jest pole count oraz lista _embedded.calculators. Pole computable: true znaczy, że kalkulator liczy biblioteka; embeddable: true, że ma widżet.

2. 2

   Pobierz opis jednego kalkulatora

   Kopiuj

   curl -s https://cyfromat.pl/api/v1/calculators/rata-kredytu.json

   Najważniejsze pola odpowiedzi:

   • parameters: jakie dane przyjmuje (typ, jednostka, min i max),
   • example: gotowy przykład, który możesz od razu przekazać do calculate,
   • _links: adresy powiązanych zasobów (schemat, strona kalkulatora, widżet).
3. 3

   Użyj katalogu w kodzie JavaScript

   Kopiuj

   const res = await fetch("https://cyfromat.pl/api/v1/calculators/rata-kredytu.json");
   const info = await res.json();
   
   console.log(Object.keys(info.parameters));
   // ["loanAmount", "interestRate", "loanTermYears", "repaymentType", "monthlyOverpayment"]
   
   // przykład z katalogu możesz przekazać prosto do biblioteki:
   import { calculate } from "https://cyfromat.pl/lib/v1/cyfromat.mjs";
   const { result } = calculate("rata-kredytu", info.example);

Katalog jest tylko do odczytu (metoda GET) i dostępny z dowolnej domeny (CORS), więc możesz go wołać prosto z przeglądarki. Format odpowiedzi to HAL (_links, _embedded).

Zasady korzystania

• Użycie bezpłatne, także komercyjne. Zachowaj link do Cyfromat.pl w widżecie.
• Wyniki mają charakter poglądowy i nie są poradą finansową, podatkową ani prawną. Pokaż to użytkownikom.
• Brak kluczy API i limitów, ale prosimy o buforowanie katalogu (cache: 1 godzina).
• Zmiany niekompatybilne pojawią się pod nowym prefiksem (/api/v2/, /lib/v2/).
• Błąd lub pomysł? Napisz do nas.

Historia zmian

1.0.0 (11 października 2026): katalog HAL, biblioteka JS (16 kalkulatorów), widżety iframe (28 kalkulatorów).