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

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.

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":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

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.

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.

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

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.