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

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.

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

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.

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.

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

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.