🔌 КалкуляторName

& Тақвим

API ҳамон математикаро иҷро мекунад, ки вебсайт истифода мебарад. Маънои майдонҳои ҳисобкунакро ҳамчун параметрҳои дархост ё JSON фиристед ва натиҷаҳои ҳисобшударо ҳамчун JSON баргардонед - аз ҷумла ҳар як нақшаи амортизатсия ё маълумоти диаграмма, ки ҳисобкунак истеҳсол мекунад.

• 198+ ҳисобкунакҳо, ҳар кадом бо нуқтаи охири худ
• Калиди API нест — дастрасии номаълум, суръати маҳдудшуда аз IP
• CORS — Access-Control-Allow-Origin: * (истифодашавандаи тарафҳои мизоҷон)
• Маҳдудияти суръат: 60 дархостҳо/ соат барои IP (HTTP 429 дар вақти зиёдшавӣ)

URL- и асосӣ

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

Индекс — рӯйхати ҳамаи ҳисобкунакҳо

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

Рӯйхати ҳамаи ҳисобкунакҳои хондашавандаи мошинаро бо ҳар як майдон (кило, нишона, намуд, пешфарз, якӣ) ва калидҳои натиҷа бармегардонад - барои сохтани муштарӣ динамикӣ кофист.

Ҳисобкунӣ — иҷро кардани як ҳисобкунак

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":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Ҳисобкунакҳои кишваршинос (ипорат, қарз, андози даромад, андози фурӯши...) қабул мекунанд ?country=us|uk|ca|au|in|ie|nz|za. Неизвестный slug возвращает 404; не поддерживаемая страна или неверный ввод возвращает 400 с полезным сообщением и полем спецификации.

Аслшиносӣ ва нақшаҳо

Шумо метавонед 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-и маҳдудшуда) ё калиди ройгон бо квотаи моҳонаи хурд. На тиҷоратӣ.
• Тайёркунанда — 100
• Корӣ — 1000♠1000

Вақте ки квота-и моҳонаи калид истифода мешавад, 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);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

Ҳамаи нуқтаҳои охирин

Як нуқтаи охирин барои ҳар як ҳисобкунак. Калидҳои замина ва калидҳои натиҷа барои ҳар як дар /api/v1/ индекс.