🔌 Свободен калиброващ API

Преглед

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. Неизвестен полз връща 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"

• Безплатен — анонимна (ограничена ставка на КИП) или свободен ключ с малка месечна квота.
• Разработчик — $9/mo — 10 000 обаждания месечно, търговска употреба.
• Бизнес — $49/mo — 100 000 обаждания на месец, приоритетен пропуск.

Когато се използва месечна квота на ключ, API връща HTTP 429 с грешка "quota_ превишена"; неизвестен или неактивен ключ връща 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/ индекс.