🔌 Gratis Calculator API

Overzicht

De API draait precies dezelfde wiskunde die de website gebruikt. Stuur de veldwaarden van een rekenmachine als query parameters of JSON en krijg de berekende resultaten terug als JSON..inclusief eventuele amortisatie schema of grafiek gegevens die de rekenmachine produceert.

• 198+ rekenmachines, elk met zijn eigen eindpunt
• Geen API-sleutel — anonieme toegang, tarief beperkt door IP
• CORS — Access-Control-Allow-Origin: * (bruikbare client-side)
• Maximumpercentage: 60 aanvragen/uur per IP (HTTP 429 indien overschreden)

Basis-URL

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

Index.. elke rekenmachine

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

Geeft een machineleesbare lijst van alle rekenmachines met elk zijn velden (sleutel, label, type, standaard, eenheid) en resultaattoetsen genoeg om een client dynamisch te bouwen.

Bereken.. run een rekenmachine

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

Responsvorm:

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

Landbewuste rekenmachines (hypotheken, leningen, inkomsten-belasting, sales-tax...) accepteren ?country=us|uk|ca|au|in|ie|nz|za. Onbekende kogel geeft 404 terug; niet ondersteund land of slechte invoer geeft 400 terug met een nuttig bericht en het veldspec.

Authenticatie & plannen

U kunt de API bellen zonder sleutel op alle.. anonieme verzoeken zijn tarief-beperkt door IP. Voor een hogere, voorspelbare maandelijkse quota (en commercieel gebruik), maak een sleutel op uw account pagina en stuur het een van de drie manieren:

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"

• Vrij — anoniem (IP-tarief beperkt) of een gratis sleutel met een kleine maandelijkse quota. Niet-commercieel.
• Ontwikkelaar — $9/mo — 10.000 gesprekken/maand, commercieel gebruik.
• Business — $49/mo — 100.000 oproepen/maand, prioriteit doorvoer.

Wanneer het maandelijkse quotum van een sleutel wordt gebruikt, geeft de API HTTP 429 terug met fout "quota_exceed"; een onbekende of inactieve sleutel geeft HTTP 401 terug. Zie volledige plannen en meld je aan op de Prijzen blz..

Voorbeelden

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 eindpunten

Een eindpunt per rekenmachine. Veldtoetsen en resultaattoetsen voor elk zijn in de /api/v1/ index.