🔌 Калкулятор

Күзәтү

API сайтта кулланылган математика белән бер үк математиканы эшли. Калкуляторның өлешләре бәяләрен сорау параметрлары яки JSON буларак җибәрегез һәм исәпләнгән нәтиҗәләрне JSON буларак кайтарыгыз — калькулятор җитештергән һәрбер амортизация графикы яки диаграмма мәгълүматлары белән бергә.

• 198+ калькуляторлар, һәрберсенең үз ахыры бар
• API ключы юк — аноним керү, IP белән чикләнгән тизлек
• CORS — Access-Control-Allow-Origin: * (клиент тарафыннан кулланыла торган)
• Скорость чикләүе: 60 IP адресы буенча сораулар/саат (HTTP 429 чиктән тыш булганда)
• Errors are free — only a successful (2xx) response uses one call from your monthly quota. Every 400, 401, 404, 429 and 500 costs you nothing.

Баш URL

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

Индекс — һәрбер калькулятор исемлеге

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

Һәрбер уенның үз тематикасы бар, һәрбер уенның үз темасы бар, һәрбер уенның үз темасы бар, һәрбер уенның үз темасы бар, һәрбер уенның үз темасы бар. Each field also carries a required flag — true for the few fields that have no default (dates, mostly). Send those: a couple of calculators can infer one, the rest answer 400 without it.

Калькулятор

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

Җавап формасы:

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

Җирле калкуляторлар (ипотека, кредит, керем салымы, сату салымы...) кабул итә ?country=us|uk|ca|au|in|ie|nz|za. 404 — өч урынлы җөп сан, 404 дән соң килә торган җөп сан, 404 дән соң килә торган җөп сан.

Parameters, defaults and errors

Send only the fields you care about. Anything you leave out is filled with that field's published default — the same value the calculator page pre-fills, so the API and the website always return the same numbers for the same inputs. Each response lists what it filled in under defaults_applied.

Anything the API cannot resolve honestly is an error, never a zero: a misspelled parameter, a value of the wrong type, an unknown dropdown option, or a missing field that has no default (the date fields — a birth date cannot be guessed). Every 400 names the offending parameter and echoes the full field spec so a client can correct itself.

$ 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/ index publishes every field's key, type, unit, default and whether it is required — enough to build a client that never guesses.

Аутентификация

Сез APIны ключсыз да чакыра аласыз - аноним сораулар IP буенча чикләнгән. Күпрәк, алдан фаразланган айлык квота өчен (һәм коммерцияле куллану өчен), хисап битегездә ключ булдырыгыз һәм аны өч ысулның берсендә җибәрегез:

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"

• Бушлай — аноним (IP тизлеге чикләнгән) яки ай саен аз гына түләү белән бушлай ключ. Коммерцияле түгел.
• Программистлар өчен $9/ай — 1000 елда нигезләнгән.
• Бизнес — 1000 елдан соң, 1000 елдан соң, 1000 елдан соң.

What counts against your quota

Only a successful response does. One 2xx = one call. Every error is free: a 400 for a misspelled parameter, a bad value or a missing required field, a 404 for an unknown slug, a 401 for a bad key, a 429, and anything that goes wrong on our side. Explore the contract and fix your request as many times as you need — you are billed for answers, not for corrections.

Because errors are free they are rate-limited instead: if one key provokes more than 200 rejected responses in an hour, it gets HTTP 429 "too_many_invalid_requests" until the hour rolls over. Successful calls never count towards that, so a working integration will never see it — it only catches a client stuck in a retry loop.

HTTP 429 — HTTP протоколы, HTTP 401 — HTTP протоколы, HTTP 429 — HTTP протоколы, HTTP 401 — HTTP протоколы, HTTP 401 — HTTP протоколы. Төп мәкалә: Кырымтатар теле Кырымтатар теленең диалектлары һәм диалектик төрләре бар. Сатып алу бит.

Мәсәлән

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

Барлык ахыр нокталар

Бер калькулятор өчен бер тәмамлану урыны. Һәрберсенең кыр һәм нәтиҗә клавишлары /api/v1/ индекс.