🔌 API Áireamhán Saor in Aisce

Forbhreathnú

Seol luachanna réimse an áireamháin mar pharaiméadair cheiste nó mar JSON agus faigh na torthaí ríofa ar ais mar JSON — lena n-áirítear aon sceideal dímheasa nó sonraí cairte a tháirgeann an t-áireamhán.

• 198+ áireamháin, gach ceann acu lena chríochphointe féin
• Gan eochair API — rochtain gan ainm, ráta-teoranta ag IP
• CORS — Access-Control-Allow-Origin: * (inúsáidte ar thaobh an chliaint)
• Teorainn Ráta: 60 iarratais/uair an chloig in aghaidh an IP (HTTP 429 nuair a sháraítear)
• 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 Bun

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

Innéacs — liosta gach áireamháin

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

Fillteann sé liosta inléite ag meaisín de gach áireamhán le réimsí gach ceann acu (eochair, lipéad, cineál, réamhshocrú, aonad) agus eochracha toraidh — go leor chun cliant a thógáil go dinimiciúil. 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.

Ríomh — rith áireamhán amháin

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

Cruth an fhreagra:

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

Glac le háireamháin tír-eolach (morgáiste, iasacht, cáin ioncaim, cáin díolacháin...) ?country=us|uk|ca|au|in|ie|nz|za. Tuairisceán slug anaithnid 404; tír neamh-thacaithe nó droch-ionchur ar ais 400 le teachtaireacht cabhrach agus an spec réimse.

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.

Fíordheimhniú agus pleananna

Is féidir leat glaoch ar an API gan eochair ar chor ar bith - tá iarratais anaithnid ráta-teoranta ag IP. Chun cuóta míosúil níos airde, intuartha (agus úsáid tráchtála), a chruthú eochair ar do leathanach cuntas agus é a sheoladh ar cheann de thrí bhealach:

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"

• Saor — anaithnid (IP ráta-teoranta) nó eochair saor in aisce le cuóta míosúil beag. Neamhthráchtála.
• Forbróir & mdash; $9/ mí — 10,000 glaoch/mí, úsáid tráchtála.
• Gnó & mdash; $ 49 / mí — 100,000 glaonna / mí, tríthoiseach tosaíochta.

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.

Nuair a úsáidtear cuóta míosúil eochrach suas, tugann an API HTTP 429 ar ais le hearráid "quota_exceeded"; tugann eochair anaithnid nó neamhghníomhach HTTP 401 ar ais. Féach pleananna iomlán agus clárú ar an Praghsáil leathanach.

Samplaí

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

Gach Deireadhphointe

Tá eochracha réimse agus eochracha toraidh do gach ceann acu sa bhileog oibre. /api/v1/ innéacs.