🔌 I-Calculator ye-API ekhululekileyo

Iinkcukacha

I-API iqhuba i-mathematics efanayo esetyenziswa yiwebhusayithi. Thumela amaxabiso endawo ye-calculator njengeparameters zombuzo okanye i-JSON kwaye ufumane iziphumo ezibalo-manani zibuyela kwi-JSON — kubandakanya nayiphi na inkqubo yokuhlawula okanye i-chart data i-calculator ivelisa.

• 198+ ii-calculators, nganye inendawo yayo
• Akukho sitshixo se-API — Unikezelo olungaziwayo, unikezelo olukhawulezayo oluphelelwe lixesha yi-IP
• CORS — Access-Control-Allow-Origin: * (i-client-side esetyenziswayo)
• Umda wexabiso: 60 izicelo/iyure nge-IP nganye (HTTP 429 xa igqityiwe)

Isiseko se URL

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

Isalathisi - luhlu lwe calculator nganye

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

Ibuyisela uluhlu olufundekayo ngematshini lwazo zonke iicalculator ezinezithuba nganye (iqhosha, ilabel, uhlobo, okungagqibekanga, iyunithi) kunye nezitshixo zeziphumo - ezinenzuzo yokwakha umxhasi ngokulula.

I-Calculator

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

Uhlobo lwempendulo:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Ii-calculators ezizimeleyo zelizwe (i-mortgage, i-loan, i-income-tax, ?country=us|uk|ca|au|in|ie|nz|za. Icebo elingaziwayo libuyisela 404; ilizwe elingaxhaswanga okanye ungeniso olubi libuyisela 400 nomyalezo oncedisayo kunye nendawo ekhankanywe.

Ubungqina & inkqubo

Ungabiza i-API ngaphandle kwesitshixo nantoni na - izicelo ezingaziwayo zikhawuleziwe yi-IP. Ukufumana ixabiso eliphezulu, elilindelekeyo lenyanga (nesicelo sorhwebo), yenza isitshixo kwiphepha le-akhawunti yakho kwaye uyithumelele enye yeendlela ezintathu:

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"

• Iinketho ze-GNU/Linux — i-IP engaziwayo (IP ekhawulezayo-ekhawulezayo) okanye iqhosha elikhululekileyo elinomlinganiselo omncinci wenyanga.
• Umbhekisi phambili — $9/mo — 10,000 uqhagamshelwano/inyanga, ukusetyenziswa korhwebo.
• Ishishini — $49/ngonyaka — 100,000 uqhagamshelwano/inyanga, unikezelo oluphambili.

Xa iqhosha le-quota yenyanga lisetyenziswa i-API ibuyisela i-HTTP 429 enempazamo "quota_exceeded"; iqhosha elingaziwayo okanye elikhubazekileyo libuyisela i-HTTP 401. Iinkqubo zeNkqubo yeNkqubo Ixabiso Iphepha.

Iimizekelo

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);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

Zonke iziphelo

I-1 endpoint nganye ye-calculator. Iqhosha lendawo kunye neqhosha leziphumo ngalinye likwi- /api/v1/ Isalathisi.