🔌 Free Calculator APIName

Тұжырымдамасы

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 жылдамдығы шектелген) немесе ай сайын аз мөлшерде берілетін тегін кілт. Коммерциялық емес.
• Жасаушы $9/ ай — 10-нан астам түрі бар, оның ішінде 10-нан астам түрі ендеш.
• Бизнес — $49/ай — 100♠100♠100

Кілттің айлық квотасының шегі өткенде 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/ индекс.