🔌 Free Calculator API

Prehľad

Rozhranie API vykonáva presne rovnakú matematiku, akú používa webová stránka. Odošlite hodnoty polí kalkulačky ako parametre dotazu alebo JSON a získajte vypočítané výsledky späť ako JSON. Zahŕňajú všetky amortizačné plány alebo grafy, ktoré kalkulačka vygeneruje.

• 198+ Kalkulačky, každá s vlastným koncovým bodom
• Žiadny API kľúč — Anonymný prístup, rýchlosť obmedzená podľa IP
• CORS — Access-Control-Allow-Origin: * (použiteľné na strane klienta)
• Limit sadzby: 60 požiadaviek/hodina na IP (HTTP 429 pri prekročení)

Základná URL

https://calculator.free/api/v1/

Index — zobrazí zoznam všetkých kalkulačiek

GET https://calculator.free/api/v1/

Vráti strojovo čitateľný zoznam všetkých kalkulačiek s každým z polí (kľúč, označenie, typ, predvolené, jednotka) a kľúče výsledkov - dosť na dynamické vytvorenie klienta.

Výpočet — spustenie jednej kalkulačky

GET  https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/     (JSON or form body)

Tvar odozvy:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Kalkulačky pre jednotlivé krajiny (hypotéka, pôžička, daň z príjmu, daň z predaja...) akceptovať ?country=us|uk|ca|au|in|ie|nz|za. Neznámy slug vracia 404; nepodporovaná krajina alebo zlé zadanie vracia 400 s užitočnou správou a špecifikáciou poľa.

Overenie & plány

Rozhranie API môžete volať bez kľúča. Anonymné požiadavky sú obmedzené rýchlosťou podľa IP adresy. Ak chcete získať vyššiu, predvídateľnú mesačnú kvótu (a komerčné využitie), vytvorte kľúč na stránke svojho účtu a odošlite ho jedným z troch spôsobov:

GET  https://calculator.free/api/v1/mortgage/?price=350000&key=YOUR_KEY
curl -H "Authorization: Bearer YOUR_KEY" "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"
curl -H "X-Api-Key: YOUR_KEY"           "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"

• Voľný — Môžete si vybrať anonymný (IP rate-limited) alebo bezplatný kľúč s malou mesačnou kvótou.
• Vývojár — $9/mesiac — 10 000 hovorov/mesiac, komerčné použitie.
• Podnikanie — $49/mesiac — 100 000 hovorov/mesiac, prioritná priepustnosť.

Keď sa vyčerpá mesačná kvóta kľúča, API vráti HTTP 429 s chybou "quota_exceeded"; neznámy alebo neaktívny kľúč vráti HTTP 401. Pozrite si kompletné plány a zaregistrujte sa na Ceny strana.

Príklady

curl

curl "https://calculator.free/api/v1/mortgage/?price=350000&down=70000&rate=6.9&years=30"

JavaScript fetch()

const r = await fetch(
  "https://calculator.free/api/v1/bmi/?" + new URLSearchParams({
    units: "metric", height: "180", weight: "80"
  }));
const { results } = await r.json();
console.log(results.bmi, results.category);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

Všetky koncové body

Klávesy pre polia a kľúče výsledkov pre každý z nich sú uvedené v časti /api/v1/ index.