🔌 Free Calculator API

Kuongorora

API inoshanda nematekisi akafanana neaya ayo webhusaiti inoshandisa. Tsanangura mavara enzvimbo yechikwereti separameter yechikwereti kana JSON uye uwane zviwanikwa zvakanyorwa seJSON — kusanganisira chero nguva yekudzoka kana data remufananidzo iro chikwereti chinogadzira.

• 198+ calculators, mumwe nomumwe ne endpoint yake
• Hapana API key — anonymus access, rate-limited by IP
• CORS — Access-Control-Allow-Origin: * (usable client-side)
• Kuwedzera: 60 zvikumbiro/awa per IP (HTTP 429 kana yakakwira)
• Maitiro akasununguka — chete abudirira (2xx) mhinduro inoshandisa imwe kufona kubva yako yemwedzi quota. Every 400, 401, 404, 429 uye 500 zvinokubhadharisa chero chinhu.

Chikamu che URL

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

Index — kuratidza chero calculator

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

Inodzosera mashoko anoverenga nechigadzirwa chemachina ezvinyorwa zvese zvema calculators nenzvimbo dzese dzese (key, label, type, default, unit) uye zviratidzo zvemhedzisiro — zvakakwana kuti uite mushandisi nesimba. Kana iwe ukasarudza “Send those” (Kutumira avo), iwe uchawana mapepa ezvinyorwa zviviri zvemabhuku, imwe neimwe ine zita rayo, uye imwe neimwe ine zita remunyori.

Calculator

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

Kudzokera kumusoro

{
  "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"]
}

Country-aware calculators (mortgage, mari, income-tax, sales-tax...) kubvuma ?country=us|uk|ca|au|in|ie|nz|za. Unknown slug anodzokera 404; unsupported nyika kana bad input anodzokera 400 nemashoko anokosha uye nzvimbo spec.

Parameter, defaults uye errors

Kutumira chete maindasitiri iwe unofarira. Chii chero iwe kubvisa ari kupfurwa neiyo indasitiri's published default - iyo imwecheteyo kukosha calculator peji prefills, saka API uye website nguva dzose kudzokera zvakafanana nhamba yezvimwe zviwanikwa. defaults_applied.

Kana paine chero chinhu API haigone kubvisa, icho chinowanzova dambudziko, kwete zera: parameter yakanyorwa zvisina kunaka, kukosha kwemhando isina kunaka, sarudzo yekuwedzera-pasi isiri kuzivikanwa, kana nzvimbo isina basa ine basa rayo rakajairika (data fields — zuva rekuzvarwa risingagone kufungidzirwa). 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 inoburitsa chiratidzo chese chemunda, mhando, unit, default uye kana ichida kupihwa - zvakakwana kuti uite mushandisi asingafungi.

Kuzivana & mapurogiramu

Iwe unogona kukumbira API pasina bhatani chero kupi zvako - zvikumbiro zvisina zita zvinorambidzwa neIP. Kuti uwane huwandu hwakanyanya, hwakavimbika hwemwedzi (uye kushandiswa kwekutengesa), gadzira bhatani pawebhusaiti yako yeaccount uye tumira imwe yenzira mbiri:

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"

• _Dambudziko: — anozivikanwa (IP rate-limited) kana chiratidzo chemahara nechidiki chikwereti chemwedzi. Non-commercial.
• Developer — $9/mwedzi — 10,000 calls/month, commercial use.
• Business — $49/mwedzi — 100,000 calls/month, priority throughput.

Chii chinobata pa quota yako

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.

Nekuti matambudziko ari free ivo vari rate-yakavharwa pamusoro: kana imwe kiyi zvinokonzera kupfuura 200 kana webhusaiti yako yakasiiwa mazano munguva yeawa, inowana HTTP 429 "too_many_invalid_requests" kusvika nguva ichiri kukwira. Kubudirira kwezvikumbiro hazvina kusanganisira kusvikira, saka kubatanidzwa kwebasa hakuzoona - inotora chete mutengi akasungwa munzira yekuedza.

Kana chiratidzo chemwedzi chichishandiswa, API inodzosera HTTP 429 nematambudziko "quota_exceeded"; chiratidzo chisina kuzivikanwa kana chisina kuiswa chinodzosera HTTP 401. Ona mapurogiramu ese uye nyora pasi pa Kubhadhara peji.

Mifananidzo

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

_Zvimwe

One endpoint per calculator. Field keys uye result keys for each are in the /api/v1/ index.