🔌 Вільний 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/

Повертає придатний для читання комп' ютерний список всіх калькуляторів з полями кожного з них (ключ, label, type, default, unit) і клавіш, які можна прочитати, щоб зібрати клієнтів динамічно.

Обчислити дальше за один калькулятор

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"

• Вільно — анонімний (у обмеженнях на IP) або вільний ключ з малою квотою на місяць. Некомерційною.
• Розробник - $9/mo — 10 000 дзвінків на місяць, комерційне використання.
• Бізнес - $49/ m — 100 000 дзвінків/місяць, першочергова сеть.

Якщо буде використано місячну квоту ключа, API поверне HTTP 429 з помилкою " quota_ exceed "; невідомий або неактивний ключ поверне 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/ індекс.