🔌 Free Calculator API

Faahfaahin

API-ga wuxuu ku socdaa xisaabta saxda ah ee websaydhka. U dir qiimaha goobta xisaabinta sida baakadaha su'aasha ama JSON oo ka hel natiijada la xisaabiyey dib u noqoshada JSON - oo ay ku jiraan waqti kasta oo lacagta ama xogta shaxda ee xisaabinta soo saarta.

• 198+ xisaab-qaadayaasha, mid kasta oo ay la endpoint gaar ah
• Ma jiro furaha API — access anonymous, heerka-la xaddiday by IP
• CORS — Access-Control-Allow-Origin: * (isticmaali karo dhinaca macaamiisha)
• Xaddidaadda: 60 codsiyada/saacaddii IP kasta (HTTP 429 marka la ka dhaafay)
• Xumaantu waa bilaash — kaliya jawaabta guulaysatay (2xx) isticmaali mid ka mid ah wicitaanada ka quota bille ah. kasta oo 400, 401, 404, 429 iyo 500 waxba kuu kuugu baxa.

URL-ka asalka ah

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

Index — liiska xisaab kasta

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

Ku soo laabtaa liiska mashiinka-qaadashada ee dhammaan xisaabayaasha la mid ah qaybaha mid kasta oo ka mid ah (key, label, nooc, default, unit) iyo astaamaha natiijooyinka - ku filan in ay dhisaan macaamiisha dynamic. Qayb kasta oo ka mid ah goobta sidoo kale waxaa la socday baabuurta loo baahan yahay - runtii u ah qaybaha yar oo aan lahayn default (maalinta, inta badan). Soo dir kuwa: qaar ka mid ah xisaab-dhaqayaasha ka soo bixi kartaa mid ka mid ah, kuwa kale jawaab 400 iyada oo aan.

xisaab — xawaare xisaab mid ah

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

qaabka jawaabta:

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

xisaab-qaadayaasha dalka-aware (mortgage, deyn, dakhliga-tax, iibka-tax…) aqbalaan ?country=us|uk|ca|au|in|ie|nz|za. slug aan la aqoon ayaa ku soo laabtay 404; dalka aan la taageerin ama soo-gaadhista xun ku soo laabtay 400 la fariin caawin iyo dhul spec.

Parameters, defaults iyo khaladaadka

Soo dir oo kaliya meelaha aad ka walwasho. Wax kasta oo aad ka tagto waxaa buuxsamay oo la daabacay default ee goobtaas - qiimaha la mid ah ee bogga xisaabinta hore-buuxa, sidaas API iyo website-ka mar walba ku soo laabtaan tirada la mid ah ee injiiska la mid ah. jawaab kasta oo liiska waxa ay buuxisay hoos defaults_applied.

Wax kasta oo API ma awoodo in ay si run ah u xalliso waa qalad, marnaba aan zero: parameter misspelt, qiimaha nooca qalad ah, doorasho aan la aqoon dropdown, ama goobta la'aanta ah oo aan lahayn default (darajo taariikhda - taariikhda dhalasho ma la saadaalin karo). kasta oo 400 magacyada parameter xadgudubka iyo echoes spec goobta buuxda si macaamiisha ay u hagaajin karaan iyaga oo keliya.

$ 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": [ ... ]
}

La /api/v1/ index daabacaadda key kasta ee goobta, nooc, mid ka mid ah, default iyo haddii ay tahay in la baahan yahay - ku filan si ay u dhisaan macaamiisha in marnaba ma sheegto.

Authentication & plans

Waxaad u wici kartaa API la keydka aan waxba ku jirin dhammaan - codsiyada aan la aqoonsan ayaa la xaddiday by IP. Si aad u sare, la saadaalin karo bishii quota (iyo isticmaalka ganacsi), abuuro keydka on page xisaabtaada oo u dir mid ka mid ah saddexda hab:

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"

• Bilaash — aan la aqoon (IP-ka qiimaha-la xaddiday) ama furaha bilaash ah oo leh qaybo bil kasta oo yar.
• Developer — $9/bilood — 10,000 wicitaan / bilood, isticmaalka ganacsi.
• Ganacsiga — $49/bishii — 100,000 wicitaanada / bilood, hormuudka soo gudbinta.

Maxaa ku jira kootadaada

kaliya jawaabta guusha samayn. Mid 2xx = mid ka mid ah wicitaan. khaladaad kasta waa bilaash: a 400 si ay u parameter misspelt, qiimaha xun ama qaybta loo baahan yahay oo ka maqan, a 404 si ay u slug aan la aqoon, a 401 si ay u furaha xun, a 429, iyo wax kasta oo ka xun dhinacyadayaga. ka baaraandegi heshiiska iyo hagaajinta codsigaaga sida inta jeer oo aad u baahan tahay — waxaad la xisaabtami doonaa jawaabaha, ma aha in ay hagaajiyaan.

Sababtoo ah khaladaadka waa bilaash waxay yihiin sicirka-ka-dhiman in kastoo: haddii mid ka mid ah badhamada ka sii badan 200 jawaabaha la diiday saacad, wuxuu helaa HTTP 429 "too_many_invalid_requests" ilaa saacadda ka soo wareegto. wicitaanada guulaysta marnaba ma xisaabtaan in, sidaas darteed isku xirka shaqada marnaba ma arki doono - waxay kaliya ku qaadataa macaamiisha ku xiran isku-dhafka dib-u-taagista.

Marka keydka bille ah ee keydka la isticmaalo API ka soo laabtay HTTP 429 oo leh khalad "quota_exceeded"; keydka aan la aqoon ama aan la shaqeynin ka soo laabtay HTTP 401. Ka eeg qorshayaasha buuxa iyo diiwaangelinta on Qiimaha bogga.

tusaale

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

Dhammaan xarafyada

Mid ka mid ah endpoint per calculator. Field furayaasha iyo natiijooyinka furayaasha ee mid kasta oo ka mid ah /api/v1/ liiska.