🔌 Frjáls Reiknivél API

Yfirlit

API keyrir nákvæmlega sömu stærðfræði og vefsíðan notar. Sendu reitgildi reiknivélarinnar sem fyrirspurnarbreytur eða JSON og fáðu reiknaðar niðurstöður aftur sem JSON - þar á meðal allar afskriftaráætlanir eða töflugögn sem reiknivélin framleiðir.

• 198+ Reiknivélar, hver með eigin endapunkti
• Enginn API lykill — Nafnlaus aðgangur, takmarkaður af IP
• CORS — Access-Control-Allow-Origin: * (nothæfur biðlarahlið)
• Hraðatakmörk: 60 beiðnir/klukkustund á IP (HTTP 429 þegar farið er yfir)
• Villur eru ókeypis — Aðeins árangursríkt (2xx) svar notar eitt símtal frá mánaðarlegu kvóta þínu. Sérhver 400, 401, 404, 429 og 500 kostar þig ekkert.

Grunnslóð

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

Index — lista hverja reiknivél

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

Sýnir tölvulesanlegan lista yfir allar reiknivélar með reit hverrar reiknivélar (lykil, merki, tegund, sjálfgefið, einingu) og lykla niðurstöðu — nóg til að byggja upp viðskiptavin dynamicly. Hver reitur ber einnig nauðsynlegan flagg — satt fyrir fáeinum reitunum sem hafa ekki sjálfgefið (dagsetningar, aðallega). Senda þá: nokkrar reiknivélar geta dregið einn, restin svara 400 án þess.

Reikna — keyra eina reiknivél

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

Svarform:

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

Land-vitur reiknivélar (veðlán, lán, tekjuskatt, söluskatt...) samþykkja ?country=us|uk|ca|au|in|ie|nz|za. Óþekkt slóð skilar 404; óstuddur land eða slæmt inntak skilar 400 með hjálplegum skilaboðum og reitnum.

Breytur, sjálfgefin gildi og villur

Sendu aðeins þá reiti sem þú hefur áhuga á. Allt sem þú sleppir er fyllt út með sjálfgefnu gildi fyrir þann reit - sama gildi og reiknivélin fyllir út fyrirfram, þannig að API og vefsvæðið skila alltaf sömu tölum fyrir sömu inntak. Hvert svar sýnir hvað það fyllti út undir defaults_applied.

Allt sem API-ið getur ekki leyst upp í heiðarleika er villa, aldrei núll: rangstafað breytu, gildi af röngum gerð, óþekkt fellivalkostur, eða vantar reit sem hefur ekki sjálfgefið (dagsetningarreitirnir - fæðingardag er ekki hægt að giska á). Hver 400 heitir brotsjór breytu og endurspeglar fulla reit forskrift þannig að viðskiptavinur getur leiðrétt sig.

$ 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/ Vísitala birtir lykil hvers reits, tegund, einingu, sjálfgefið og hvort það er krafist - nóg til að byggja upp viðskiptavin sem aldrei giska.

Auðkenning & áætlanir

Þú getur hringt í API án lykils - nafnlausar beiðnir eru takmarkaðar af IP. Til að fá hærra, fyrirsjáanlegt mánaðarlegt kvóta (og viðskiptanotkun) skaltu búa til lykil á reikningssíðunni þinni og senda hann á einn af þremur vegu:

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"

• Frjáls — Þú getur fengið nafnlausa lykil (IP hraða takmarkaður) eða ókeypis lykil með litlu mánaðarlegu kvóta.
• Hönnuður & mdash; $ 9 / mánuði — 10.000 símtöl/mánuði, viðskiptanotkun.
• Viðskipti — $49/mo — 100.000 símtöl / mánuði, forgangur framleiðsla.

Hvað telst gegn kvóta þínum

Einn 2xx = eitt símtal. Sérhver villa er ókeypis: 400 fyrir ranglega stafaðar breytur, slæmt gildi eða vantar nauðsynlegan reit, 404 fyrir óþekkta slóð, 401 fyrir slæman lykil, 429 og allt sem fer úrskeiðis hjá okkur. Kannaðu samninginn og lagfærðu beiðnina eins oft og þú þarft — þú ert gjaldfærður fyrir svör, ekki fyrir leiðréttingar.

Vegna þess að villur eru ókeypis eru þeir takmarkaðir í staðinn: ef einn lykill vekur meira en 200 Ef þú hefur ekki fengið svör á klukkustund, færðu HTTP 429 "too_many_invalid_requests" þar til klukkustundin er liðinn. Vel heppnaðir símtöl teljast aldrei til þess, þannig að virkur samþætting mun aldrei sjá það - það grípur aðeins viðskiptavin sem er fastur í endurtekningarlykkju.

Þegar mánaðarlegt kvóta lykilsins er notað API skilar HTTP 429 með villu "quota_exceeded"; óþekkt eða óvirk lykill skilar HTTP 401. Sjáðu allar áætlanir og skráðu þig á Verðlagning síðu.

Dæmi

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

Allir endapunktar

Einn endapunktur fyrir hverja reiknivél. Reitlyklar og niðurstöðulyklar fyrir hvern eru í /api/v1/ Yfirlit.