🔌 Bezmaksas kalkulators API

Pārskats

API darbojas tieši to pašu matemātiku, ko izmanto mājas lapā. Sūtīt kalkulatora lauka vērtības, kā vaicājumu parametri vai JSON un saņemt skaitļos rezultātus atpakaļ kā JSON — tostarp jebkādu amortizāciju grafiku vai diagrammas dati kalkulators rada.

• 198+ kalkulatori, katram ar savu mērķa kritēriju
• Nav API atslēgas — anonīma piekļuve, procentu likmes ierobežots ar IP
• CORS — Access-Control-Allow-Origin: * (izmantojama klienta puse)
• Likmes ierobežojums: 60 pieprasījumi/stunda IP (kad pārsniegtsHTTP 429);

Pamata URL

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

Indekss – uzskaitīt katru kalkulatoru

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

Atgriež mašīnlasāmu sarakstu ar visiem kalkulatoriem ar katra laukiem (taustiņu, etiķeti, tipu, noklusējuma, vienību) un rezultātu taustiņiem — pietiekami, lai izveidotu klientu dinamiski.

Aprēķināt – palaist vienu kalkulatoru

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

Atbildes forma:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Valsts apgādnieka zaudējuma kalkulatori (hipotēka, aizdevums, ienākuma nodoklis, pārdošanas nodoklis...) pieņem ?country=us|uk|ca|au|in|ie|nz|za. Nezināms slug atgriež 404; neatbalstīta valsts vai sliktas ieejas atgriež 400 ar noderīgu ziņu un lauka spec.

Autentificēšanas & amp; plāni

Jūs varat zvanīt API bez atslēgas vispār – anonīmi pieprasījumi ir likmes ierobežo IP. Lai augstāku, prognozējamu mēneša kvotu (un komerciālo izmantošanu), izveidot atslēgu savā konta lapā un nosūtīt to uz trim veidiem:

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"

• Bezmaksas — anonīms (IP likmes ierobežojums) vai bezmaksas atslēga ar nelielu ikmēneša kvotu. Nekomerciāls.
• Izstrādātājs & mdash; $9/mo — 10 000 zvanu mēnesī, komerclietojums.
• Uzņēmējdarbība — $49/mo — 100 000 zvanu mēnesī, prioritātes caurlaide.

Kad tiek izmantota atslēgas ikmēneša kvota, API atgriež HTTP 429 ar kļūdu "kvota_ pārsniegta"; nezināma vai neaktīva atslēga atgriež HTTP 401. Skatīt pilnus plānus un pierakstīties uz Cena lapa.

Piemēri

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

Visi mērķa kritēriji

Viens mērķa kritērijs uz vienu kalkulatoru. Lauka taustiņi un rezultātu taustiņi katram ir /api/v1/ Indekss.