🔌 Free Calculator API

გადახედვა

API- ს ვებ- გვერდი იმავე მათემატიკას იყენებს. გაგზავნეთ კალკულატორის ველი პარამეტრების ან JSON- ის სახით და მიიღეთ გამოთვლილი შედეგები JSON- ში - მათ შორის ნებისმიერი ამორტიზაციის გეგმა ან დიაგრამის მონაცემები, რომელიც კალკულატორმა გამოიმუშავა.

• 198+ კალკულატორები, თითოეული თავის დასასრული წერტილით
• API გასაღები არ არსებობს — ანონიმური წვდომა, IP- ს მიერ შეზღუდული სიჩქარე
• CORS — Access-Control-Allow-Origin: * (კლიენტის მხარე)
• მოცულობა: 60 მოთხოვნები/ საათი IP- ზე (HTTP 429 გადაჭარბებისას)
• Errors are free — მხოლოდ წარმატებული (2xx) პასუხი იყენებს ერთ გამოძახებას თქვენი თვეში ერთხელ გაცემული квоტის მიხედვით. ყოველი 400, 401, 404, 429 და 500 არ ღირს თქვენთვის.

ძირითადი URL

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

ინდექსის სია - ყველა კალკულატორის სია

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

Returns a machine-readable list of all calculators with each one's fields (key, label, type, default, unit) and result keys — enough to build a client dynamically. ყველა ველი ასევე ატარებს საჭირო ფლაგს - მართალი რამდენიმე ველი, რომელთაც არ აქვთ ნაგულისხმევი (დღეები, ძირითადად). გაგზავნა: რამდენიმე კალკულატორი შეიძლება გამოვიდეს ერთი, დანარჩენი პასუხი 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. უცნობი slug- ის დაბრუნება 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": [ ... ]
}

The /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 calls/month, commercial use.
• ბიზნესი $49/თვეში — 100,000 calls/month, priority throughput.

What counts against your quota

მხოლოდ წარმატებული პასუხი ნიშნავს ამას. ერთი 2xx = ერთი გამოძახება. ყველა შეცდომა უფასოა: 400 შეცდომით დაწერილი პარამეტრის, არასწორი მნიშვნელობის ან საჭირო სფეროს არარსებობისთვის, 404 უცნობი სლაგისთვის, 401 არასწორი გასაღებისთვის, 429 და ყველა სხვა, რაც ჩვენს მხარეს შეცდომით მიდის. შეისწავლეთ კონტრაქტი და შეცვალეთ თქვენი მოთხოვნა რამდენჯერაც გსურთ - თქვენ იღებთ გადასახადს პასუხებისთვის, არა კორექციებისთვის.

რადგან შეცდომები უფასოა, ისინი სწრაფად იკეტება: თუ ერთი ღილაკი უფრო მეტს იწვევს, ვიდრე 200 თუკი 1 საათში პასუხების უარყოფა მოხდა, საათის გასვლამდე მიიღებს HTTP 429 "too_many_invalid_requests" შეტყობინებას. წარმატებული გამოძახებები არასდროს ითვლება ამ რიცხვის მიხედვით, ამიტომ მუშაობის ინტეგრაცია არასდროს ნახავს ამას - ის მხოლოდ კლიენტს იპოვნის, რომელიც ჩართულია ციკლში.

When a key's monthly quota is used up the API returns HTTP 429 with error "quota_exceeded"; an unknown or inactive key returns HTTP 401. See full plans and sign up on the ფასი გვერდი.

მაგალითები

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/ ინდექსები.