🔌 Free Calculator API

Fanoritsoritana

Mandefa ny sanda an-dafin'ny milina fanisana amin'ny endrika mpizarazara na JSON ary mahazo ny vokatra azo amin'ny endrika JSON — anisan'izany ny fandaharam-potoanan'ny fandoavam-bola na ny angon-drakitra amin'ny sary natolotry ny milina fanisana.

• 198+ calculators, samy manana ny endpoint-ny ny tsirairay
• Tsy misy famaha API — fahazoana miditra tsy fantatra, voafetra amin'ny hafainganam-pandehan'ny IP
• CORS — Access-Control-Allow-Origin: * (azo ampiasaina amin'ny lafiny mpivatsy)
• Fetra: 60 fangatahana/ora isaky ny IP (HTTP 429 rehefa mihoatra)
• Tsy misy olana — ny valinteny (2xx) mahomby ihany no mampiasa antso iray amin'ny fetra isam-bolana. Tsy misy vidiny ho anao ny 400, 401, 404, 429 ary 500 tsirairay.

URL fototra

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

Mpizaha — mametraka ny lisitry ny milina fanisana tsirairay

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

Mamaly lisitra azo vakiana amin'ny milina ahitana ireo milina fanisana rehetra miaraka amin'ny sehatr'izy ireo tsirairay (famaha, marika, karazana, lasitra, isa) sy ny famaha vokany — ampy hananganana mpivatsy miovaova. Manana saina ilaina ihany koa ny sehatr'asa tsirairay — marina ho an'ireo sehatr'asa vitsy tsy manana saina tsotra (daty, matetika). Mandefa izany: afaka maminavina iray ny milina fanisana roa, ary mamaly 400 tsy misy izany ny sisa.

Calc — mandefa milina iray

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

Safidy manokana

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

Manaiky ireo kajikajy mahafantatra ny firenena (fividianana trano, trosa, hetra-fidirana, hetra-fivarotana…) ?country=us|uk|ca|au|in|ie|nz|za. Ny slug tsy fantatra dia mamaly 404; ny firenena tsy raisina an-tànana na ny famenoana diso dia mamaly 400 miaraka amin'ny hafatra mahasoa sy ny famaritana ny sehatr'asa.

Mpizantsary, sanda tsotra ary tsy fetezana

Ireo sehatra tianao fotsiny no alefa. Ny zavatra tsy voalaza dia fenoina amin'ny sanda tsotra navoaka ho an'io sehatra io - ny sanda mitovy amin'ny sandan'ny pejy fanisana, ka ny API sy ny tranonkala dia mamerina isa mitovy foana ho an'ny angon-drakitra mitovy. Mampiseho ny zavatra namenoany eo ambanin'ny lisitra ny valinteny tsirairay defaults_applied.

Tsy mety ny zavatra tsy afaka hamaha ny API amin'ny fomba marina, tsy misy aotra: singa mpizara tsy voasoratra tsara, sanda tsy mety karazana, safidy tsy fantatra amin'ny dropdown, na sehatra tsy misy lasitra (ny sehatra daty - tsy azo eritreretina ny daty nahaterahana). Ny 400 isan'andro dia manome anarana ny singa mpizara tsy mety ary manambara ny antsipirian'ny sehatra feno mba hahafahan'ny mpizara manatsara ny tenany.

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

Ny /api/v1/ Ny index dia mamoaka ny famaha, ny karazana, ny isa, ny lasitra ary ny hoe ilaina ve izany — ampy hananganana mpihaino tsy mieritreritra mihitsy.

Fanamarinana sy drafitra

Azonao atao ny miantso ny API tsy misy famaha mihitsy — voafetra araka ny IP ny fangatahana tsy fantatra anarana. Raha te-hanana fetra isam-bolana ambony kokoa, azo antenaina (sy fampiasana ara-barotra), dia mamorona famaha ao amin'ny pejy kaontinao ary mandefa izany amin'ny fomba iray amin'ireo telo:

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"

• Free — tsy fantatra anarana (mifehy ny tahan'ny IP) na famaha maimaimpoana miaraka amin'ny saram-bola kely isam-bolana. Tsy ara-barotra.
• Mpamorona — $9/mo — 10 000 ny isan'ny kisoa.
• Asa — $49/volana — 10/volana, ny laharam-pahamehana ny fandefasana.

Inona no mihatra amin'ny quota-nao

Ny valinteny mahomby ihany no afaka manao izany. 2xx iray = antso iray. Tsy misy sarany ny tsy fetezana rehetra: 400 ho an'ny mpizara tsy voasoratra tsara, sanda ratsy na faritra tsy misy, 404 ho an'ny slug tsy fantatra, 401 ho an'ny famaha ratsy, 429, ary izay rehetra tsy mety amin'ny lafiny anay. Jereo ny fifanarahana ary hamafa ny fangatahanao araka izay ilainao — ho voatery mandoa vola ianao ho an'ny valinteny, fa tsy ho an'ny fanamboarana.

Satria malalaka ny hadisoana dia voafetra ny tahan'ny fidirana amin'ny famakiana azy: raha misy kitendry iray miteraka mihoatra noho 200 Raha tsy misy valiny nolavina tao anatin'ny ora iray, dia mahazo HTTP 429 "too_many_invalid_requests" izy mandra-pahatongan'ny fiafaran'ny ora. Tsy misy isaina amin'izany ireo antso nahomby, ka tsy ho hitan'ny fampidirana miasa izany — tsy misy afa-tsy mpivatsy iray voasakana ao anatin'ny tsipika famerenana andrana.

Ny fiteny anglisy dia manana ny fiteny anglisy, ny fiteny frantsay dia manana ny fiteny frantsay, ny fiteny alemana dia manana ny fiteny alemana, ny fiteny poloney dia manana ny fiteny poloney, ny fiteny anglisy dia manana ny fiteny anglisy. Jereo ny drafitra feno ary misoratra anarana amin'ny Famaritana ny vidin'ny entana pejy.

Ohatra

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

Ireo farany rehetra

Teboka iray amin'ny farany isaky ny milina fanisana. Ao anatin'ny /api/v1/ Fipiky.