🔌 კალკულატორიName

გადახედვა

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

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

ძირითადი URL

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

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

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

კალკულატორი ყველა ველი ასევე ატარებს საჭირო ფლაგს - მართალი რამდენიმე ველი, რომელთაც არ აქვთ ნაგულისხმევი (დღეები, ძირითადად). გაგზავნა: რამდენიმე კალკულატორი შეიძლება გამოვიდეს ერთი, დანარჩენი პასუხი 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": [ ... ]
}

ჟრჲი! /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 ოპთვმა ოჲ მვჟვუ, კჲმვპუთალნა ოჲლჱა.
• ბიზნესი $49/თვე — 100 000 ოჲგთკანთწ მვჟვფნჲ, ოპთჲპთრვრნა ოპვჟვფვნჲჟრ.

კაკგჲ ჟვ ჲრბვლვზგა გყპჳს კჲრჲპარა რთ?

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

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

2007 წლის 1 იანვარს, როდესაც ქსელის ქსელი დასრულდა, ქსელის ადმინისტრატორმა გამოაცხადა, რომ ქსელის ადმინისტრატორმა 401-ის შეცდომა გამოასწორა და 402-ის შეცდომა გამოასწორა. ოჲდლვენთ დთ ოჲლნთრვ ოლანჲგვ თ ჟვ ოპთ£აგთ ნა ჟგჲ£ჲრ ოპჲტთლ. [Translation temporarily unavailable. Please try again.] გვერდი.

მაგალითები

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