🔌 Free Calculator API

Кыскача баяндама

API веб-сайтта колдонулган математиканы аткарат. Калкулятордун талааларынын маанилерин суроо параметрлери же JSON катары жөнөтүп, эсептелген натыйжаларды JSON катары кайтарып алыңыз, анын ичинде калькулятор чыгарган амортизация графики же диаграмма маалыматтары.

• 198+ калькуляторлор, ар биринин өз аяктоо пункту бар
• API ачкыч жок — анонимдүү кирүү, ылдамдыгы IP менен чектелүүчү
• CORS — Access-Control-Allow-Origin: * (колдонулуучу клиенттик)
• Баа чектөөсү: 60 IP боюнча суроолор/саат (HTTP 429, эгерде чектен ашкан болсо)
• Каталарды оңдоо — бир гана ийгиликтүү (2xx) жооп сиздин айлык квотаңыздан бир чалууну колдонот. Ар бир 400, 401, 404, 429 жана 500 чалуу сизге эч нерсеге турбайт.

Негизги URL

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

Индекс - ар бир калькулятордун тизмеси

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

Бардык калькуляторлордун машинага окула турган тизмесин кайтарат, ар биринин полялары (ключ, ярлык, тип, предпочтительный, единица) жана натыйжа ачкычы менен - бул динамикалык клиентти түзүүгө жетиштүү. Ар бир талаа керектүү белгини да алып жүрөт - чын бир нече талаа үчүн, алар стандарттуу эмес (көбүнчө даталар). Аларды жөнөт: бир нече калькулятор бирин түшүнө алат, калгандары анысыз 400 жооп берет.

Калкып чыгаруу — бир калкып чыгаруучуну иштетүү

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 кайтарат; колдоосуз өлкө же туура эмес киргизүү 400 кайтарат, бул маалымат жана талаанын мүнөздөмөлөрү менен жардам берет.

Параметрлер, стандарттар жана каталар

Тек отправлять те поля, которые вам важны. Если вы не включите ни одного поля, то оно будет заполнено по умолчанию, т.е. с тем же значением, которое предварительно заполняет калькулятор, поэтому API и веб-сайт всегда возвращают одинаковые числа для одинаковых входов. Каждый ответ содержит список заполненных полей defaults_applied.

API чече албаган бардык нерселер ката, эч качан нуль эмес: туура эмес жазылган параметр, туура эмес типтеги маани, белгисиз түшүүчү меню параметри же стандарттуу эмес талаа жок (дата талаалары - туулган күнүн аныктоо мүмкүн эмес). Ар бир 400-жылы ката параметрдин аты жана талаанын толук спецификациясы кайталанат, ошондуктан клиент өзү оңдоп алат.

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

_Жаңы /api/v1/ индекс ар бир талаанын ачкычын, түрү, бирдигин, стандартын жана керектүү экендигин жарыялайт - эч качан болжолдобогон клиентти түзүүгө жетиштүү.

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

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/месяц — 10 000 чалуу/ай, коммерциялык колдонуу.
• Бизнес $49/ай — 100 000 чалуу/ай, приоритеттүү өткөрүү жөндөмдүүлүгү.

Сиздин квотаңызга эмнелер кирет

Только успешный ответ. Одно 2xx = одно вызовы. Каждая ошибка бесплатна: 400 для неправильно написанного параметра, неправильного значения или отсутствия требуемого поля, 404 для неизвестного слага, 401 для неправильного ключа, 429 и любая ошибка, которая происходит с нашей стороны. Контракты изучите и исправьте свой запрос столько раз, сколько вам нужно - счет за ответы, а не за исправления.

Каталарды жок кылуу үчүн, алар ылдамдыгы чектелген: эгер бир баскыч бирден көп катаны жаратса 200 Эгерде бир сааттын ичинде жоопторду четке какса, сааттын аягына чейин HTTP 429 "too_many_invalid_requests" деген билдирүү келет. Жеңил чакыруулар эч качан бул көрсөткүчкө кошулбайт, ошондуктан иштей турган интеграция аны эч качан көрө албайт - ал тек гана кайра аракеттенүү циклинде калган клиентти табат.

Ачкычтын айлык квотасынын чеги өткөндө API HTTP 429 менен "quota_exceeded" катасын кайтарат; белгисиз же активдүү эмес ачкыч HTTP 401ди кайтарат. толук пландарды көрүү жана жазылуу Баалар бет.

Мисалдар

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/ индекс.