🔌 Free Calculator API

ସମୀକ୍ଷା

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/

ପ୍ରତ୍ୟେକ କ୍ଷେତ୍ର ସହିତ ସମସ୍ତ ଗଣନାକାରୀର ଗୋଟିଏ ମେସିନ-ପଢ଼ାଯୋଗ୍ୟ ତାଲିକାକୁ ଫେରାଇଥାଏ (କି, ନାମପଟି, ପ୍ରକାର, ପୂର୍ବନିର୍ଦ୍ଧାରିତ, ଏକକ) ଏବଂ ଫଳାଫଳ କି - ଗ୍ରାହକକୁ ଗତିଶୀଳ ଭାବରେ ନିର୍ମାଣ କରିବା ପାଇଁ ଯଥେଷ୍ଟ। ପ୍ରତ୍ୟେକ କ୍ଷେତ୍ର ମଧ୍ୟ ଗୋଟିଏ ଆବଶ୍ୟକୀୟ ଫ୍ଲାଗକୁ ଧାରଣ କରିଥାଏ - କିଛି କ୍ଷେତ୍ର ପାଇଁ ଯାହାର କୌଣସି ପୂର୍ବନିର୍ଦ୍ଧାରିତ ନାହିଁ (ତାରିଖ, ଅଧିକାଂଶ) । ସେମାନଙ୍କୁ ପଠାନ୍ତୁ: କିଛି ଗଣନାକାରୀ ଗୋଟିଏ ଧାରଣ କରିପାରିବେ, ବାକିମାନେ ଏହା ବିନା ୪୦୦ ଉତ୍ତର ଦେଇପାରିବେ ।

ଗଣନା କରନ୍ତୁ — ଗୋଟିଏ କାଲକୁଲେଟର ଚଲାନ୍ତୁ

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 ସମ୍ପୂର୍ଣ୍ଣ ଭାବରେ ସମାଧାନ କରିନପାରିଥିବା ଯେକୌଣସି ବିଷୟଟି ଗୋଟିଏ ତ୍ରୁଟି, କେବେ ଶୂନ୍ଯ ନୁହଁ: ଗୋଟିଏ ଭୁଲ ବନାନ ପ୍ରାଚଳ, ଭୁଲ ପ୍ରକାରର ଗୋଟିଏ ମୂଲ୍ଯ, ଗୋଟିଏ ଅଜଣା ଡ୍ରାପଡାଉନ ବିକଳ୍ପ, କିମ୍ବା ଗୋଟିଏ ଲୁପ୍ତ କ୍ଷେତ୍ର ଯାହାର କୌଣସି ପୂର୍ବନିର୍ଦ୍ଧାରିତ ନାହିଁ (ତାରିଖ କ୍ଷେତ୍ର - ଜନ୍ମ ତାରିଖକୁ ଅନୁମାନ କରାଯାଇପାରିବ ନାହିଁ)। ପ୍ରତି ୪୦୦ ଥର ଅପରାଧୀ ପ୍ରାଚଳର ନାମ ଏବଂ ସମ୍ପୂର୍ଣ୍ଣ କ୍ଷେତ୍ର ବିଶେଷତାକୁ ଅନୁସରଣ କରିଥାଏ ଯେହେତୁ ଗ୍ରାହକ ନିଜକୁ ସଠିକ କରିପାରେ।

$ 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 ଗୋଟିଏ ଅଜଣା slug ପାଇଁ, ଗୋଟିଏ 401 ଗୋଟିଏ ଖରାପ କି ପାଇଁ, ଗୋଟିଏ 429, ଏବଂ ଆମ ପଟରୁ ଯାହା କିଛି ଖରାପ ହୋଇଯାଏ। କଣ୍ଟ୍ରାକ୍ଟକୁ ଅନୁସନ୍ଧାନ କରନ୍ତୁ ଏବଂ ଆପଣଙ୍କର ଅନୁରୋଧକୁ ଯେତେଥର ଆବଶ୍ୟକ ସେତେଥର ସୁଧାରନ୍ତୁ - ଆପଣ ଉତ୍ତର ପାଇଁ ବିଲ୍ କରାଯାଏ, ସଠିକତା ପାଇଁ ନୁହେଁ।

କାରଣ ତ୍ରୁଟିଗୁଡ଼ିକ ମୁକ୍ତ ସେମାନେ ବଦଳରେ ହାରାହାରି ସୀମିତ: ଯଦି ଗୋଟିଏ କି ଅଧିକରୁ ଅଧିକ ପ୍ରେରଣା ଦେଇଥାଏ 200 ଗୋଟିଏ ଘଣ୍ଟାରେ ପ୍ରତ୍ୟାଖ୍ୟାନ ପ୍ରତ୍ଯୁତ୍ତର, ଏହା HTTP 429 "too_many_invalid_requests" ପାଇଥାଏ ଯେପର୍ଯ୍ୟନ୍ତ ଘଣ୍ଟା ଅତିକ୍ରାନ୍ତ ହୋଇନଥାଏ। ସଫଳ କଲଗୁଡ଼ିକ କେବେ ବି ଏଥିପ୍ରତି ଗଣନା କରିନଥାଏ, ତେଣୁ ଗୋଟିଏ କାର୍ଯ୍ୟକାରୀ ସଂଯୋଜକତାକୁ କେବେବି ଦେଖିପାରିବେ ନାହିଁ - ଏହା କେବଳ ଗୋଟିଏ ଗ୍ରାହକକୁ ଗୋଟିଏ ପୁନଃପ୍ରୟାସ ଲୁପରେ ଅଟକିଥିବା ଧରିଥାଏ।

ଯେତେବେଳେ ଗୋଟିଏ କିର ମାସିକ କୋଟାକୁ ବ୍ୟବହାର କରାଯାଏ 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);

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/ ଅନୁକ୍ରମଣିକା.