🔌 KalkuliloName

@ title: window

La API rulas la precize saman matematikon kiun la retejo uzas. Sendu kalkulilajn kampvalorojn kiel demandparametroj aŭ JSON kaj ricevu la kalkulitajn rezultojn kiel JSON - inkluzive de ajna amortizo aŭ diagramaj datumoj kiujn la kalkulilo produktas.

• 198+ kalkuliloj, ĉiu kun sia propra finopunkto
• Neniu API-ŝlosilo — anonima aliro, rapidec- limigita per IP
• CORS — Access-Control-Allow-Origin: * (uzebla klientflanke)
• Limito de rapideco: 60 petoj/ horo po IP (HTTP 429 se superita)

Baza URLo

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

Indekso — listigas ĉiun kalkulilon

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

Redonas maŝinlegindajn listojn de ĉiuj kalkuliloj kun la kampoj de ĉiu (ŝlosilo, etikedo, tipo, defaŭlta, unuo) kaj rezultoŝlosiloj — sufiĉe por konstrui klienton dinamike.

Kalkuli — lanĉi unu kalkulilon

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

Respondoformo:

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

Land-konsciaj kalkuliloj (hipoteko, prunto, enspezimposto, vend-imposto...) akceptas ?country=us|uk|ca|au|in|ie|nz|za. Nekonata ŝraŭbo redonas 404; nesubtenita lando aŭ malbona enigo redonas 400 kun helpa mesaĝo kaj la kampospecifo.

Aŭtentigo

Vi povas voki la API sen ŝlosilo - anonimaj petoj estas limigitaj laŭ IP. Por pli alta, antaŭvidebla monata kvoto (kaj komerca uzo), kreu ŝlosilon en via kontpaĝo kaj sendu ĝin unu el tri manieroj:

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"

• Libera — anonima (IP- limigita) aŭ libera ŝlosilo kun malgranda monata kotizo. Nekomerca.
• Programisto — $9/mo — 1000♠ 1000♠ 100♠ 1000
• Business — $49/mo — 100.000 personoj, ĉefe en la ĉefurbo.

Kiam la monata kvoto de ŝlosilo estas elĉerpita, la API redonas HTTP 429 kun eraro "quota_exceeded"; nekonata aŭ neaktiva ŝlosilo redonas HTTP 401. Vidu plenajn planojn kaj subskribu por la Prezoj paĝo.

Ekzemploj

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}'

Ĉiuj finpunktoj

Unu finpunkto por kalkulilo. Kampaj kaj rezulto-klavoj por ĉiu estas en la /api/v1/ indekso.