🔌 Gratis kalkulator-API

Oversikt

API kjører nøyaktig samme matematikk som nettstedet. Send en kalkulators feltverdier som spørreparametrer eller JSON og få de beregnede resultatene tilbake som JSON – medregnet alle avskrivningsplaner eller diagramdata som kalkulatoren produserer.

• 198+ kalkulatorer, hver med sitt endepunkt
• Ingen API- nøkkel — anonym tilgang, ratebegrenset av IP
• CORS — Access-Control-Allow-Origin: * (brukbar klientside)
• Rentegrense: 60 forespørsler/time per IP (HTTP 429 når overskridelsen er overskredet)
• Feilene er ledige — bare et vellykket (2xx) svar bruker ett anrop fra din månedlige kvote. Hvert 400, 401, 404, 429 og 500 koster deg ingenting.

Basis- URL

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

Indeks — liste for hver kalkulator

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

Gir en maskinlesbar liste over alle kalkulatorer med hver enkelt felt (nøkkel, merkelapp, type, standard, enhet) og resultattaster – nok til å bygge opp en klient dynamisk. Hvert felt har også et flagg som trengs – for de få feltene som ikke har noen standard (datoer, for det meste). Send disse: et par kalkulatorer kan vise et, resten svarer 400 uten det.

Beregn — kjør én kalkulator

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

Svarform:

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

Regnere som kjenner landskap (lån, lån, inntektsskatt, salgsskatt osv.) godtar ?country=us|uk|ca|au|in|ie|nz|za. Ukjent slør gir 404; landet er ikke støttet, eller dårlig inndata gir 400 med et nyttig meldingsområde og feltspesifikasjonen.

Parametre, standardinnstillinger og feil

Send bare de feltene du bryr deg om. Alt du lar være er fylt med det feltets publiserte standard – samme verdi som kalkulatorsiden fyller ut på forhånd, så API og nettstedet returnerer alltid de samme tallene for de samme inndata. Hvert svar viser det som fylles ut under defaults_applied.

Alt API ikke kan løse erlig er en feil, aldri en null: en feilstavet parameter, en verdi av feil type, et ukjent fallskjermvalg, eller et manglende felt som ikke har noen standard (datofeltene – en fødselsdato kan ikke gjettes). Hvert 400- navn gir motsvarende parameter og gir et ekko av hele feltspesifikasjonen slik at klienten kan rette seg selv.

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

Den /api/v1/ indeks offentliggjør nøkkelen, typen, enheten, standard og om det er nødvendig med en slik nøkkel, og om den er nødvendig — nok til å bygge en kunde som aldri gjettar.

Autentiserings- & - planer

Du kan ringe API uten nøkkel i det hele tatt – anonyme forespørsler er takstbegrenset av IP. For en høyere, forutsigbar månedlig kvote (og kommersiell bruk), opprett en nøkkel på kontosiden din og send den på en av tre måter:

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"

• Ledig — anonym (IP- sats begrenset) eller en fri nøkkel med en liten månedlig kvote. Ikke- kommersiell.
• Utvikler — $9/mo — 10 000 anrop/måned, kommersiell bruk.
• Business — $49/mo — 100.000 anrop/måned, prioritert gjennomstrømning.

Hva teller mot kvoten din

Bare et vellykket svar gjør. Ett 2xx = ett kall. Hver feil er ledig: 400 for en feilstavet parameter, en dårlig verdi eller et manglende påkrevd felt, 404 for en ukjent snegle, 401 for en dårlig tast, 429 og alt som går galt på vår side. Utforsk kontrakten og rett opp din forespørsel så mange ganger du trenger – du faktureres for svar, ikke for rettelser.

Fordi feil er frie er de ratebegrenset i stedet: hvis en nøkkel provoserer mer enn 200 avvist svar om en time, får det HTTP 429 « too_ mange_ unified_ requests » til timen ruller over. Vellykkede samtaler teller aldri til det, så en integrasjon vil aldri se det – den fanger bare en klient som sitter fast i en retry- sløyfe.

Når en nøkkels månedlige kvote brukes opp, gir API HTTP 429 med feil « quota_ exceed »; en ukjent eller inaktiv nøkkel gir HTTP 401. Se fullstendige planer og meld deg inn på Prisfastsettelse side.

Eksempler

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 endepunkter

Ett endepunkt pr. kalkulator. Felttaster og resultattaster for hver er i /api/v1/ indeks.