🔌 Free Calculator API

Kufotokozera

Kutumiza mfundo za nyanja ya calculator monga mafunso ofunikira kapena JSON ndi kupeza zotsatira zowerengedwa kumbuyo monga JSON - kuphatikizapo nthawi iliyonse ya amortization kapena deta ya chart yomwe calculator imapanga.

• 198+ calculators, aliyense ndi yake yokha endpoint
• Palibe API key — kulowa kwa anonymous, kuwonjezeka kwa IP
• CORS — Access-Control-Allow-Origin: * (Kugwiritsa ntchito kwa client-side)
• Kusinthanitsa: 60 zofuna / ola pa IP (HTTP 429 pamene anapitilira)
• Mavuto ndi ufulu — 2xx) yankho ntchito wina kufunsa kuchokera mwezi wanu malire. Zonse 400, 401, 404, 429 ndi 500 ndalama inu chilichonse.

Base URL

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

Index — mnda wa aliyense calculator

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

Kubwerera makina-kuwerenga mnda wa onse calculators ndi aliyense wa iwo nyanja (chingwe, label, mtundu, default, yunitsi) ndi zotsatira zidutswa - zokwanira kulenga mnzake dynamically. Gawo lililonsenso ali ndi zofunika flag — weniweni kwa malo angapo kuti alibe default (zikondwerero, makamaka). Kutumiza iwo: awiri calculators angagwiritse ntchito mmodzi, ena anayankha 400 popanda izo.

Kuwerengera — kuyendetsa imodzi calculator

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

Kuyankha:

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

Countries-aware calculators (mphatso, ngongole, ndalama-tax, malonda-tax...) kuvomereza ?country=us|uk|ca|au|in|ie|nz|za. Unknown slug amabwerera 404; osati wothandiza dziko kapena zoipa mkati amabwerera 400 ndi uthenga wothandiza ndi nyanja spec.

Parameters, defaults ndi zolakwika

Kutumiza okha nyanja inu kusamala za. chilichonse inu kuchotsa anadzaza ndi nyanja imeneyi kufalitsa default - mfundo imodzi calculator page prefills, kotero API ndi webusaiti nthawi zonse kubwezera ofanana mitengo kwa ofanana mfundo. defaults_applied.

Chomwe API sichingathe kuchotsa mwamsanga ndi vuto, si zero: paramita yolemba mosayenera, mtengo wa mtundu wosayenera, mwayi wopanda malire, kapena gawo lofunikira lomwe silinathe (madera a tsiku - tsiku lobadwa silingathe kuganiziridwa).Kawirikawiri 400 amatchedwa paramita yotsutsana ndi kuyankhulana ndi nyanja yonse kuti kasitomala akhoza kusinthidwa.

$ 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 amafalitsa chida cha chilichonse cha nyanja, mtundu, yunitsi, default ndi ngati chimafunikira - chokwanira kukhazikitsa kasitomala yemwe sakudziwa.

Kutsimikizira & maphunziro

Mukhoza kufunsa API popanda chida chilichonse - zopempha zosadziwika zimatha kukhazikitsidwa ndi IP. Kuti mupange ndalama zowonjezereka, zoyembekezeka (ndi ntchito zapachuma), yambitsani chida patsamba lanu la akaunti ndikutumiza imodzi mwanjira zitatu:

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"

• Wosuta — Kugwiritsa ntchito chida ichi kumatha kukhala kopanda dzina (IP yokhala ndi mtengo wotsika) kapena chida chosalipira ndi ndalama zochepa za mwezi.
• Wopanga & mdash; $ 9 / mo — 10,000 mafoni / mwezi, kugwiritsa ntchito malonda.
• Ntchito — $49 / mwezi — 100,000 mafoni / mwezi, cholinga kudzera.

Zimene zimawerengedwa pa quota yanu

One 2xx = one call. Gawo lililonse vuto ndi ufulu: a 400 kwa misspelt paramita, zoipa mtengo kapena kulephera zofunika nyanja, a 404 kwa slug osadziwika, a 401 kwa zoipa batani, a 429, ndi chilichonse chimene chimapita mosayenera pa mbali yathu. Kukaona mgwirizano ndi kukhazikitsa zosowa zanu nthawi zambiri monga inu muyenera — inu ndinu zolipira kwa mafunso, si kwa zosintha.

Chifukwa zoipa ndi ufulu iwo ndi mtengo-otsika m'malo: ngati wina waukulu amachititsa zambiri kuposa 200 Ngati yankho la HTTP likanavomerezedwa m'mawa, limakhala HTTP 429 "too_many_invalid_requests" mpaka nthawi yopitilira. Zomwe zimachitikazo sizimawerengedwa motsutsana ndi izi, chifukwa chake kuphatikizidwa kogwira ntchito sikudzawona - imatha kuzindikira kasitomala wokhala ndi vuto la kuyesera.

Ngati chida cha mwezi chimagwiritsa ntchito ndalama zokwanira, API imatumiza HTTP 429 ndi vuto la "quota_exceeded"; chida chosadziwika kapena chosagwira ntchito chimatumiza HTTP 401. Onani zolinga zonse ndi kulembetsa pa Kugulitsa tsamba.

Misonkho

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

Zomwe zilipo

Mmodzi endpoint kwa calculator. Field zilembo ndi zotsatira zilembo kwa aliyense ndi m'munsimu /api/v1/ index.