🔌 Gratis regnemaskine API

Oversigt

API kører nøjagtig samme matematik hjemmesiden bruger. Send en regnemaskine felt værdier som forespørgsel parametre eller JSON og få de beregnede resultater tilbage som JSON! herunder enhver amortisering tidsplan eller diagram data lommeregneren producerer.

• 198+ regnemaskiner, hver med sit eget endepunkt
• Ingen API- nøgle — anonym adgang, rentebegrænset af IP
• CORS — Access-Control-Allow-Origin: * (Anvendelig klientside)
• Procentgrænse: 60 anmodninger/time pr. IP (HTTP 429 når overskridelsen er overskredet)
• Fejl er gratis — Kun et vellykket (2xx) svar bruger et opkald fra din månedlige kvote. Hver 400, 401, 404, 429 og 500 koster dig ingenting.

Basis- URL

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

Indeks! liste hver regnemaskine

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

Returnerer en maskinlæsbar liste over alle regnemaskiner med hver enkelts felter (nøgle, etiket, type, standard, enhed) og resultat nøgler! nok til at opbygge en klient dynamisk. Hvert felt bærer også et obligatorisk flag ~ true for de få felter, der ikke har nogen standard (datoer, for det meste). Send dem: et par regnemaskiner kan inferere en, resten svar 400 uden det.

Compute! køre en regnemaskine

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

Land-bevidst regnemaskiner (mortgage, lån, indkomst-skat, salg-skat...) acceptere ?country=us|uk|ca|au|in|ie|nz|za. Ukendt slug returnerer 404; ikke-støttet land eller dårlig input returnerer 400 med en nyttig besked og feltet spec.

Parametre, standardværdier og fejl

Send kun de felter, du holder af. Alt du udelader er fyldt med dette felts offentliggjort standard ! den samme værdi regnemaskine side præ-fyld, så API og hjemmesiden altid returnere de samme tal for de samme indgange. Hver svar lister, hvad det udfyldte under defaults_applied.

Alt API kan ikke løse ærligt er en fejl, aldrig et nul: en forkert stavet parameter, en værdi af den forkerte type, en ukendt dropdown mulighed, eller et manglende felt, der ikke har nogen standard (datofelterne • en fødselsdato kan ikke gættes). Hver 400 navne den krænkende parameter og ekkoer den fulde felt spec, så en klient kan rette sig 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": [ ... ]
}

Det /api/v1/ indeks udgiver hvert felts nøgle, type, enhed, standard og om det er nødvendigt! nok til at opbygge en klient, der aldrig gætter.

Autentificering og planer

Du kan ringe til API'en uden nøgle på alle ~ anonyme anmodninger er rate-begrænset af IP. For en højere, forudsigelig månedlig kvote (og kommerciel brug), oprette en nøgle på din konto side og sende det en af tre måder:

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"

• Fri — anonym (IP-sats-begrænset) eller en gratis nøgle med en lille månedlig kvote. Ikke-kommerciel.
• Udvikler & mdash; $9/mo — 10.000 opkald/måned, kommerciel brug.
• Business — $49/mo — 100.000 opkald/måned, prioritets-gennemløb.

Hvad tæller mod din kvote?

Kun en vellykket respons gør. En 2xx = et opkald. Hver fejl er gratis: en 400 for en forkert stavet parameter, en dårlig værdi eller et manglende påkrævet felt, en 404 for en ukendt kugle, en 401 for en dårlig nøgle, en 429, og noget, der går galt på vores side. Udforsk kontrakten og løse din anmodning så mange gange som du har brug for! du er faktureret for svar, ikke for rettelser.

Fordi fejl er gratis, er de rate-begrænset i stedet: hvis en nøgle provokerer mere end 200 afviste svar i en time, det får HTTP 429 "too_many_invalid_requests" indtil timen ruller over. Succesfulde opkald aldrig tælle i retning af det, så en fungerende integration vil aldrig se det! det kun fanger en klient fast i en retry loop.

Når en nøgles månedlige kvote er brugt op API returnerer HTTP 429 med fejl "quota_exceed"; en ukendt eller inaktiv nøgle returnerer HTTP 401. Se alle planer og tilmeld dig Prissætning 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 endpoints

Et endpoint pr. regnemaskine. Feltnøgler og resultatnøgler for hver er i /api/v1/ indeks.