🔌 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);
• Kļūdas ir brīvas — tikai veiksmīgs (2xx) atbilde izmanto vienu zvanu no jūsu mēneša kvotas. Katra 400, 401, 404, 429 un 500 jums neko nemaksā.

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. Katrs lauks arī veic nepieciešamo karogu — kas attiecas uz dažiem laukiem, kam nav noklusējuma (datumi, galvenokārt). Sūtīt tos: pāris kalkulatori var infer vienu, pārējais atbilde 400 bez tā.

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":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

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.

Parametri, noklusējumi un kļūdas

Sūtīt tikai laukus, par kuriem jūs rūpējaties. Viss, ko jūs atstājat, ir aizpildīts ar šī lauka publicēto noklusējuma vērtību – to pašu vērtību, kādu kalkulatora lapas aizpildīšana, tāpēc API un tīmekļa vietne vienmēr atgriež tos pašus skaitļus, kas nepieciešami tām pašām ievadēm. Katrā atbildē ir norādīts, ko tā aizpilda zem defaults_applied.

Viss, ko API nevar godīgi atrisināt, ir kļūda, nekad nav nulle: nepareizs parametrs, nepareiza tipa vērtība, nezināma nolaišanās opcija, vai trūkstošs lauks, kam nav noklusējuma (datuma lauki — dzimšanas datumu nevar uzminēt). Katrs 400 nosaukumi aizskarošais parametrs un atbalso pilnu lauku spec, lai klients varētu izlabot sevi.

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

, ja /api/v1/ indekss publicē katru lauka atslēgu, tips, vienība, noklusējuma un vai tas ir nepieciešams — pietiekami, lai izveidotu klientu, kas nekad uzmin.

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.

Kas ir attiecībā pret jūsu kvotu

Tikai veiksmīga atbilde. Viens 2xx = viens zvans. Katra kļūda ir brīva: 400 kļūdaini parametram, slikta vērtība vai trūkstošs nepieciešamais lauks, 404 nezināmam slugam, 401 sliktai atslēgai, 429, un jebkas, kas noiet greizi mūsu pusē. Izpētiet līgumu un izlabojiet savu pieprasījumu tik reizes, cik jums nepieciešams — jums tiek pieprasītas atbildes, nevis labojumi.

Jo kļūdas ir bez maksas, tās ir ierobežotas ar likmi: ja viena atslēga provocē vairāk nekā 200 noraidītas atbildes stundas laikā, tas saņem HTTP 429 "too_many_inderderfults_requests" līdz brīdim, kad stunda rita virs tās. Veiksmīgi zvani nekad nerēķinās ar to, tāpēc darba integrācija nekad neredzēs — tas tikai noķer klientu iestrēguši atkal uzciršanas cilpā.

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

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

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.