🔌 Sakrekenaar

Oorsig

Die API loop presies dieselfde wiskunde wat die webwerf gebruik. Stuur 'n sakrekenaar se veldwaardes as navraag parameters of JSON en kry die berekende resultate terug as JSON ← insluitend enige aortisering skedule of kaart data wat die sakrekenaar vervaardig.

• 198+ sakrekenaars, elk met sy eie punt
• Geen API-sleutel nie — anonieme toegang, tempo-verwag deur IP
• CORS — Access-Control-Allow-Origin: * (bruikbaare kliënt-side)
• Spoed:: 60 versoeke/hour per IP (HTTP 429 wanneer oorskry)

Basis URL

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

Indeks eenmaalLOX lys elke sakrekenaar

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

Gee terug 'n masjienleesbare lys van alle sakrekenaars met elke een se velde (sleutel, etiket, tipe, verstek, eenheid) en resultaat sleutels Jesaja genoeg om 'n kliënt inamiese te bou.

Compute jacter loop een sakrekenaar

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

Reaksie vorm:

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

Land- aware sakrekenaars (mortgage, lening, inkomste-tax, verkoop-tax...) aanvaar ?country=us|uk|ca|au|in|ie|nz|za. Onbekende slug gee terug 404; nie ondersteunde land of slegte invoer gee terug 400 met 'n nuttige boodskap en die veld se spek.

Geldigheidsverklaring & planne

Jy kan die API bel sonder 'n sleutel by alle vandaan kom anonieme versoeke word gegradeer deur IP. Vir' n hoër, voorspelbare maandelikse kwota (en kommersiële gebruik), skep 'n sleutel op jou rekening bladsy en stuur dit een van drie maniere:

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"

• Beskikbaar — anoniem (IP tempo-verwag) of 'n vrye sleutel met' n klein maandelikse kwota. Nie- kommersiale.
• ontwikkelaar &madash; $9/m — 10 000 oproepe/month, kommersiële gebruik.
• Besigheid &madash; R129/m — 100 000 oproepe/month, prioriteit deurpag.

Wanneer 'n sleutel se maandelikse kwota gebruik word begin die API gee terug HTTP 49: met fout "quota_ exceed";' n onbekende of onaktiewe sleutel gee terug HTTP 401. Sien volle planne en teken op Comment bladsy.

Voorbeelde

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

Alle puntpunte

Een punt gestel per sakrekenaar. Veldsleutels en resultaat sleutels vir elk is in die /api/v1/ indeks.