🔌 মুক্ত ক্যালকুলেটর API

সারসংক্ষেপ

API ওয়েবসাইটের ব্যবহার করা একই গণিত চালায়। একটি ক্যালকুলেটরের ক্ষেত্র মানগুলি অনুসন্ধান পরামিতি বা JSON হিসাবে পাঠান এবং JSON হিসাবে গণনাকৃত ফলাফলগুলি ফিরে পেতে - ক্যালকুলেটর দ্বারা উত্পাদিত যেকোন amortization সময়সূচী বা চার্ট তথ্য সহ।

• 198+ ক্যালকুলেটর, প্রত্যেকটি তার নিজস্ব শেষ বিন্দু সহ
• API কী নেই — বেনামী প্রবেশাধিকার, IP দ্বারা সীমাবদ্ধ
• CORS — Access-Control-Allow-Origin: * (ব্যবহারযোগ্য ক্লায়েন্ট-সাইড)
• হারের সীমা: 60 প্রতি IP- এ অনুরোধ/ ঘন্টা (HTTP ৪২৯ অতিক্রম করলে)
• ভুল মুক্ত — শুধুমাত্র একটি সফল (2xx) প্রতিক্রিয়া আপনার মাসিক কোটা থেকে একটি কল ব্যবহার করে। প্রতিটি ৪০০, ৪০১, ৪০৪, ৪২৯ এবং ৫০০-এর জন্য আপনার খরচ হবে না।

ভিত্তি ইউ- আর- এল

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. অজানা স্লাগ ৪০৪ ফিরিয়ে দেয়; অসমর্থিত দেশ বা ভুল ইনপুট ৪০০ ফিরিয়ে দেয় একটি সহায়ক বার্তা এবং ক্ষেত্র স্পেসিফিকেশন সহ।

প্যারামিটার, ডিফল্ট এবং ত্রুটি

শুধুমাত্র আপনি যে ক্ষেত্রগুলির প্রতি মনোযোগ প্রদান করেন তা প্রেরণ করুন। আপনি যে কোন ক্ষেত্র বাদ দিলে তা সেই ক্ষেত্রটির প্রকাশিত ডিফল্ট মান দ্বারা ভর্তি হবে - ক্যালকুলেটর পৃষ্ঠার পূর্বপূর্ব ভর্তির মান, তাই 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 rate-limited) অথবা একটি বিনামূল্যে কী যা মাসে একটি ছোট কোটা দিয়ে থাকে। অবাণিজ্যিক।
• ডেভেলপার — $9/মাস — ১০,০০০ কল/মাস, বাণিজ্যিক ব্যবহারের জন্য।
• ব্যবসা — $৪৯/মাস — ১০০,০০০ কল/মাস, অগ্রাধিকার প্রদান করা হবে।

আপনার কোটায় কি গণনা করা হবে

শুধুমাত্র সফল প্রতিক্রিয়াই কাজ করে। একটি 2xx = একটি কল। প্রতিটি ত্রুটি বিনামূল্যে: ভুল বানান, একটি ভুল মান অথবা একটি অনুপস্থিত আবশ্যক ক্ষেত্র, একটি অজানা স্লাগ, একটি 401 একটি খারাপ কী, একটি 429, এবং আমাদের পক্ষ থেকে যা কিছু ভুল হয় তার জন্য একটি 400। চুক্তি অনুসন্ধান করুন এবং আপনার অনুরোধ যতবার প্রয়োজন ততবার ঠিক করুন - আপনি উত্তরের জন্য বিল করা হবে, সংশোধন করার জন্য নয়।

যেহেতু ত্রুটি মুক্ত তারা বদলে রেট- লিমিটেড: যদি একটি কী এর চেয়ে বেশি উদ্দীপক 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/ সূচী.