🔌 Kalkulator

Kaca

API punika nglampahi matematika ingkang sami kaliyan ingkang dipunginakaken déning situs. Kirih nilai-nilai medan kalkulator kados parameter pitakonan utawi JSON lan pikantuk hasil ingkang dipunkalkulasi malih kados JSON - kados ta jadwal amortisasi utawi data grafik ingkang dipunproduksi déning kalkulator.

• 198+ kalkulator, saben karo titik pungkasan dhewe
• Ora ana kunci API — anonymous access, rate-limited by IP
• CORS — Access-Control-Allow-Origin: * (bisa digunakaké klien-sisi)
• Batas laju: 60 pitakon/jam saben IP (HTTP 429 nalika ngluwihi)
• Errors are free — only a successful (2xx) response uses one call from your monthly quota. Every 400, 401, 404, 429 and 500 costs you nothing.

URL Dasar

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

Indeks - nyathet saben kalkulator

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

Ngganti dhaptar kalkulator kang bisa dibaca mesin kanthi saben pérangan (kunci, label, jinis, default, unit) lan kunci asil — cukup kanggo mbangun klien kanthi dinamis. Each field also carries a required flag — true for the few fields that have no default (dates, mostly). Send those: a couple of calculators can infer one, the rest answer 400 without it.

Kalkulator

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

Bentuk balasan:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

Kalkulator kang ngerti nagara (mortgage, pinjaman, pajak penghasilan, pajak penjualan...) nampa ?country=us|uk|ca|au|in|ie|nz|za. Ing taun 1940, dhèwèké gabung karo grup musik The Beatles, nanging ora tau main ing panggung.

Parameters, defaults and errors

Send only the fields you care about. Anything you leave out is filled with that field's published default — the same value the calculator page pre-fills, so the API and the website always return the same numbers for the same inputs. Each response lists what it filled in under defaults_applied.

Anything the API cannot resolve honestly is an error, never a zero: a misspelled parameter, a value of the wrong type, an unknown dropdown option, or a missing field that has no default (the date fields — a birth date cannot be guessed). Every 400 names the offending parameter and echoes the full field spec so a client can correct itself.

$ curl "https://calculator.free/api/v1/mortgage/?price=350000&rate=6.5&term=30"
{
  "ok": false,
  "error": "unknown_parameter",
  "message": "Unknown parameter 'term' for calculator 'mortgage'. Did you mean 'years'? ...",
  "unknown_parameters": ["term"],
  "did_you_mean": { "term": "years" },
  "valid_parameters": ["down", "extra", "extra_onetime", "extra_yearly", "hoa",
                       "insurance", "other", "pmi", "price", "rate", "tax", "years"],
  "fields": [ ... ]
}

The /api/v1/ index publishes every field's key, type, unit, default and whether it is required — enough to build a client that never guesses.

Otentikasi

Sampeyan bisa ngadhepi API tanpa kunci - pitakonan anonim diwatesi kanthi IP. Kanggo kuota wulan kang luwih dhuwur lan bisa diprediksi (lan kanggo panggunaan komersial), buat kunci ing kaca akun lan kirim salah siji saka telung cara:

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"

• Bebas — anonim (IP rate-limited) utawa kunci gratis kanthi quota sawulan cilik. Non-komersial.
• Developer — $9/month — 10.000/taun, lan 10.000/taun kanggo konsumsi domestik.
• Bisnis — $49/wulan — 100.000,-/taun, lan 100.000,-/taun kanggo gawéan.

What counts against your quota

Only a successful response does. One 2xx = one call. Every error is free: a 400 for a misspelled parameter, a bad value or a missing required field, a 404 for an unknown slug, a 401 for a bad key, a 429, and anything that goes wrong on our side. Explore the contract and fix your request as many times as you need — you are billed for answers, not for corrections.

Because errors are free they are rate-limited instead: if one key provokes more than 200 rejected responses in an hour, it gets HTTP 429 "too_many_invalid_requests" until the hour rolls over. Successful calls never count towards that, so a working integration will never see it — it only catches a client stuck in a retry loop.

Nalika 1990-an, gawéan-gawéan kang digawé déning perusahaan iki ora mung didol ing Amérika Sarékat, nanging uga didol ing mancanagara. Liwat program iki, para siswa bisa sinau lan ngrampungake tugas-tugas ing sekolah. Pricing kaca.

Conto

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);

Python

import requests

r = requests.get("https://calculator.free/api/v1/mortgage/",
                 params={"price": 350000, "down": 70000,
                         "rate": 6.9, "years": 30},
                 headers={"Authorization": "Bearer YOUR_KEY"})
print(r.json()["results"])

POST JSON

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

Sekabeh titik pungkasan

Satunggal titik pungkasan per kalkulator. Kunci medan lan kunci asil kanggé saben punika wonten ing /api/v1/ indeks.