🔌 Laisvas skaičiaviklis API

Apžvalga

API veikia tiksliai tą pačią matematiką svetainėje naudoja. Siųsti skaičiuotuvo lauko vertes, kaip užklausos parametrai arba JSON ir gauti kompiuterinių rezultatų atgal kaip JSON – įskaitant bet amortizacijos tvarkaraštis arba diagramos duomenis skaičiuotuvas sukuria.

• 198+ skaičiuotuvai, kiekvienas su savo vertinamąja baigtimi
• Nr API raktas — anonimiška prieiga, palūkanų normos ribojamos IP
• CORS — Access-Control-Allow-Origin: * (naudojama kliento pusė)
• Normos riba: 60 užklausos per IP (perskaičiuojant HTTP 429)

Pagrindinis URL

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

Indeksas – sąrašas

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

Grįžta į mašininio nuskaitymo sąrašą visų skaičiuotuvų su kiekvieno laukų (raktas, etiketė, tipas, numatytoji, vienetas) ir rezultatų raktai – pakankamai, kad dinamiškai sukurti klientą.

Apskaičiuoti – paleisti vieną skaičiuoklę

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

Atsako forma:

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

Įrangos skaičiuotuvai (automatiniai, paskolos, pajamų-mokesčiai, pardavimo-mokesčiai...) ?country=us|uk|ca|au|in|ie|nz|za. Nežinomas šliaužimas grįžta 404; nepalaikoma šalis arba blogas indėlis grąžinami 400 su naudingu pranešimu ir lauke spec.

Autentikacijos & amp; planai

Galite skambinti API be rakto visai – anoniminiai prašymai yra ribojamas IP. Dėl didesnės, nuspėjamos mėnesio kvotos (ir komercinio naudojimo), sukurti raktą savo sąskaitos puslapyje ir siųsti jį vienas iš trijų būdų:

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"

• Laisva — anonimiškas (IP norma apribota) arba nemokamas raktas su maža mėnesio kvota. Nekomercinis.
• Programuotojas & mdash; $9/mo — 10 000 skambučių per mėnesį, komercinis naudojimas.
• Verslo & mdash; $49/mo — 100 000 skambučių per mėnesį, pirmumo pralaidumas.

Kai naudojama rakto mėnesio kvota, API grąžina HTTP 429 su klaida "kvota_ viršijama"; nežinomas arba neaktyvus raktas grįžta HTTP 401. Žr. išsamius planus ir užsiregistruoti Kainos puslapis.

Pavyzdžiai

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 tyrimo tikslai

Vienas rezultatas vienam skaičiuoklė. Lauko klavišai ir rezultatų raktai kiekvienam yra /api/v1/ Rodyklė.