🔌 API calculatoare gratuite

Aviz general

API rulează exact aceeași matematică utilizată de site. Trimite valorile unui calculator de câmp ca parametri de cerere sau JSON și obține rezultatele calculate înapoi ca JSON – inclusiv orice program de amortizare sau datele de grafică produse de calculator.

• 198+ calculatoare, fiecare cu propriul punct de vedere final
• Nicio cheie API — acces anonimat, limitat de rată prin IP
• CORS — Access-Control-Allow-Origin: * (utilizabil pe partea clientului)
• Limita ratei: 60 cereri/ora pe IP (HTTP 429 după depășire)
• Eroarele sunt gratuite — Doar un răspuns de succes (2xx) foloseşte un apel din cota lunară. Fiecare 400, 401, 404, 429 şi 500 nu vă costă nimic.

URL de bază

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

Indice – listă fiecare calculator

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

Returnează o listă de calculatoare în mod automat cu câmpurile fiecărui (cheie, etichetă, tip, implicit, unitate) și chei de rezultate — suficient pentru a construi un client dinamic. Fiecare câmp poartă, de asemenea, un steag necesar — adevărat pentru cele puține câmpuri care nu au implicit (date, în principal). Trimiteți cele: un cuplu de calculatoare poate inferi unul, restul răspunde 400 fără el.

Calculator – rula un calculator

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

Forma răspunsului:

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

Calculatoarele de țară conștienți (mortage, împrumut, venit-impozitare, vânzări-tax...) ?country=us|uk|ca|au|in|ie|nz|za. Slug necunoscut întoarce 404; țară necunoscută sau intrare proastă întoarce 400 cu un mesaj util și specificațiile de câmp.

Parametri, implicite și erori

Trimite doar câmpurile de care vă interesează. Orice ce lăsați afară este umplut cu acest câmp publicat implicit — aceeași valoare pe care pagina calculatoare pre-umple, astfel API și site-ul întotdeauna returnează același numere pentru aceleași inputuri. Fiecare răspuns listă ceea ce este completat în defaults_applied.

Orice API nu poate rezolva sincer este o eroare, nu un zero: un parametr errata, o valoare a tipului greşit, o opţiune de downdown necunoscută sau un câmp lipsă care nu are nici o valoare implicită (cadrările datei — o dată de naştere nu poate fi ghicit). Fiecare 400 numeşte parametrul ofensivo şi ecoează specificaţiile complete de câmp astfel încât un client să poată corecta în sine.

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

The /api/v1/ indexul publică cheia, tip, unitate, implicit și dacă este necesar — suficient pentru a construi un client care nu ghiceste niciodată.

Planuri de & amp; de autentificare

Puteți apela API fără cheie, de asemenea, cereri anonime sunt limitate de rată de IP. Pentru o cotă lunară mai mare și previzibilă (și utilizarea comercială), creați o cheie pe pagina contului și trimiteți-l una din trei moduri:

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"

• Gratuit — anonimă (limitată la rata IP) sau o cheie gratuită cu o cotă lunară mică.
• Dezvoltator & mdash; 9$/mo — 10 000 de apeluri/lună, folosirea comercială.
• Afaceri & mdash; 49/mo — 100.000 de apeluri/lună, de la priorităţi.

Ce contează împotriva cotei tale

Doar un răspuns de succes. Un 2xx = un apel. Fiecare eroare este gratuit: un 400 pentru un parametr incorect, o valoare proastă sau un câmp lipsă necesar, un 404 pentru un slug necunoscut, un 401 pentru o cheie proastă, un 429, și orice care merge prost de partea noastră. Explorați contractul și corectați cererea de câte ori aveţi nevoie - sunteți facturați pentru răspunsuri, nu pentru corecții.

Pentru că erorile sunt libere, acestea sunt limitate la rată în schimb: dacă o cheie provoacă mai mult decât 200 răspunsurile respinse într-o oră, acesta devine HTTP 429 "too_many_read_readnevil_requests" până la o oră rulează peste. apelurile de succes nu se numără niciodată în acest sens, astfel încât o integrare de lucru nu va vedea niciodată – aceasta prinde doar un client blocat într-o bucla de repetiție.

Când cota lunară a cheilor este utilizată în API returnează HTTP 429 cu eroare "quota_ exces"; o cheie necunoscută sau inactivă întoarce HTTP 401. Vezi planurile complete şi înscrie-te pe Prețuri pagina.

Exemple

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

Toate punctele finale

Un punct final pe calculator. Cheile de câmp și cheile de rezultat pentru fiecare sunt în /api/v1/ indice.