🔌 Prosti API za kalkulator

Pregled

API izvaja popolnoma enako matematiko, kot spletna stran uporablja. Pošljite kalkulatorjeve vrednosti kot parametre za poizvedbo ali JSON in dobite izračunane rezultate nazaj kot JSON – vključno z vsemi amortizacijo ali graf podatkov, ki jih kalkulator proizvaja.

• 198+ kalkulatorji, vsak z lastnim opazovanim dogodkom
• Brez ključa API — anonimni dostop, omejen s OP
• CORS — Access-Control-Allow-Origin: * (Uporabljiva stranke)
• Omejitev stopnje: 60 zahteve/uro na OP (HTTP 429, če je preseženo)
• Napake so brezplačne — Samo uspešen (2xx) odziv uporablja en klic iz mesečne kvote. Vsakih 400, 401, 404, 429 in 500 vas ne stane nič.

Osnovni URL

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

Indeks – seznam vsakega kalkulatorja

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

Vrne strojno čitljiv seznam vseh kalkulatorjev z vsakim poljem (ključ, oznaka, tip, privzeto, enota) in izidnimi ključi – dovolj, da se stranka dinamično zgradi. Vsako polje ima tudi zahtevano zastavo – velja za nekaj polj, ki nimajo privzetih (datumi, večinoma). Pošljite te: nekaj kalkulatorjev lahko zaključek enega, preostali odgovor 400 brez njega.

Izračunaj – izženi en kalkulator

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

Oblika odziva:

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

Računalniki, ki so zavedani države (mortgaža, posojilo, dohodek-davek, prodajni davek...) sprejmejo ?country=us|uk|ca|au|in|ie|nz|za. Neznana polža vrne 404; nepodprta država ali slab vnos vrne 400 z uporabnim sporočilom in specifičnim poljem.

Parametri, privzeti in napake

Pošljite samo polja, ki vam so všeč. Vse kar pustite je zapolnjeno z objavljenim privzetjem tega polja – enaka vrednost, ki jo je kalkulator strani predpolnil, tako da API in spletna stran vedno vrne iste številke za iste vhode. Vsak odgovor navede, kaj je zapolnjen v pod defaults_applied.

Vse, kar API ne more pošteno rešiti, je napaka, nikoli nič: napačno napisane parametre, vrednost napačne vrste, neznana možnost padanja ali manjkajoče polje, ki nima privzeto (polja za datume – datum rojstva ni mogoče uganiti). Vsakih 400 imen vreden parameter in odzove celoten specifični element polja, tako da se stranka lahko popravi.

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

-Sigurno je. /api/v1/ indeks objavlja ključe vsakega polja, tip, enoto, privzeto in ali je to potrebno – dovolj, da se zgradi stranka, ki nikoli ne ugiba.

Načrti & amp; za preverjanje

API lahko kličete brez ključa – anonimne zahteve so omejene s IP. Za višjo, predvidljivo mesečno kvoto (in komercialno uporabo), ustvarite ključ na vaši strani računa in jo pošljete na en od treh načinov:

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"

• Prosto — anonimni (omejena stopnja OP) ali prosti ključ z majhno mesečno kvoto.
• Razvijalec – $9/mo — 10.000 klicev mesečno, komercialna uporaba.
• Poslovni položaj – 49/mo — 100.000 klicev na mesec, prednostna izhodi.

Kaj je pomembno v zvezi s tvojo kvoto

Samo uspešen odziv. En 2xx = en klic. Vsaka napaka je brezplačna: 400 za napačno napako parametr, slaba vrednost ali manjkajoče polje, 404 za neznan polž, 409 za slab ključ, in vse, kar gre narobe na naši strani. Raziščite pogodbo in popravite svojo zahtevo tolikokrat, kolikor potrebujete – ste plačani za odgovore, ne za popravke.

Ker so napake brezplačne, so omejene namesto: če en ključ izzove več kot 200 zavrnjeni odzivi v uri, dobi HTTP 429 "too_maly_pogrešek_requests" dokler se ura ne vrne. Uspešni klici nikoli ne štejejo za to, tako da ga delovna integracija nikoli ne bo videla – lovi le stranko, ki je obtičala v zanke ponovno.

Ko se uporabi mesečna kvota za ključ, API vrne HTTP 429 z napako » quota_ oversed«; neznana ali neaktivna tipka vrne HTTP 401. Glejte načrte in se prijavite na Cene stran.

Primeri

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

Vsi opazovani dogodki

En končni cilj na kalkulator. Ključi polja in rezultati za vsakega so v /api/v1/ indeks.