🔌 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)
• Fouten zijn vrij — slechts een succesvolle (2xx) reactie gebruikt één oproep uit uw maandelijkse quota. Elke 400, 401, 404, 429 en 500 kosten u niets.

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. Elk veld draagt ook een vereiste vlag..

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":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

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.

Parameters, standaardwaarden en fouten

Stuur alleen de velden waar je om geeft. Alles wat je weglaat is gevuld met dat veld is gepubliceerd standaard.. Dezelfde waarde de rekenmachine pagina voor-fills, zodat de API en de website altijd dezelfde nummers voor dezelfde invoer. Elke reactie lijsten wat het ingevuld onder defaults_applied.

Alles wat de API niet eerlijk kan oplossen is een fout, nooit een nul: een fout gespelde parameter, een waarde van het verkeerde type, een onbekende dropdown optie, of een ontbrekende veld dat geen standaard heeft (de datumvelden.. een geboortedatum kan niet worden geraden). Elke 400 namen de beledigende parameter en echo's van het volledige veld spec, zodat een client zichzelf kan corrigeren.

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

De /api/v1/ index publiceert de sleutel, het type, de eenheid, de standaard en of het nodig is.. genoeg om een client te bouwen die nooit raadt.

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.

Wat telt tegen je quota

Alleen een succesvol antwoord doet. Een 2xx = één oproep. Elke fout is gratis: een 400 voor een fout gespelde parameter, een slechte waarde of een ontbrekende vereiste veld, een 404 voor een onbekende kogel, een 401 voor een slechte sleutel, een 429, en alles wat mis gaat aan onze kant. Verken het contract en fix uw verzoek zo vaak als je nodig hebt..U wordt gefactureerd voor antwoorden, niet voor correcties.

Omdat fouten vrij zijn, zijn ze in plaats daarvan beperkt: als één sleutel meer dan 200 afgewezen reacties in een uur, het krijgt HTTP 429 "too_many_invalid_requests" totdat het uur rollen over. Succesvolle oproepen nooit tellen om dat, dus een werkende integratie zal nooit zien. Het vangt alleen een client vast in een retry loop.

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

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

Alle eindpunten

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