এআই সহকারী এবং ডেভেলপারদের জন্য RupeeKit
ক্যালকুলেটর এপিআই এবং এমসিপি ডকুমেন্টেশন
5-ক্যালকুলেটর উৎসযুক্ত পাইলটটি একটি রিড-অনলি JSON API বা MCP এন্ডপয়েন্টের মাধ্যমে ব্যবহার করুন। ক্যালকুলেটরের ইনপুট, ডিফল্ট, সীমা, আউটপুটের নাম, পদ্ধতি, অনুমান, ক্যানোনিকাল পৃষ্ঠা, পর্যালোচিত তারিখ, উৎস, গোপনীয়তার বিজ্ঞপ্তি এবং দাবিত্যাগ মেশিন-পঠনযোগ্য আকারে ফেরত দেওয়া হয়।
JSON API এন্ডপয়েন্ট
| পদ্ধতি | এন্ডপয়েন্ট | উদ্দেশ্য |
|---|---|---|
| পেতে | /api/v1/calculators | পর্যালোচিত পাইলট প্রোগ্রামের প্রতিটি ক্যালকুলেটর এবং তার সঠিক ইনপুট চুক্তি তালিকাভুক্ত করুন। |
| পেতে | /api/v1/calculators/{slug} | একটি ক্যালকুলেটরের ইনপুট, ডিফল্ট, আউটপুট ফিল্ড, পদ্ধতি এবং উৎসগুলো জানুন। |
| পোস্ট | /api/v1/calculators/{slug} | ক্যালকুলেটরটি চালান। সাংখ্যিক মানগুলো একটি inputs অবজেক্টের ভেতরে পাঠান। |
REST গণনার উদাহরণ
POST https://www.rupeekit.co.in/api/v1/calculators/personal-loan-true-apr-calculator-india
Content-Type: application/json
{
"inputs": {
"principal": 500000,
"annualInterestRate": 12,
"tenureMonths": 36,
"processingFeePercent": 2,
"gstPercent": 18,
"insuranceAndOtherUpfront": 5000,
"advanceEmis": 0
}
}16 কিলোবাইটের বেশি নয় এমন একটি বডি সহ application/json পাঠান। অনুরোধ থেকে বাদ দেওয়া ইনপুটগুলির জন্য নথিভুক্ত ডিফল্ট মান ব্যবহৃত হবে। অজানা কী, অ-সংখ্যাসূচক মান, সীমার বাইরের মান, ত্রুটিপূর্ণ JSON, অসমর্থিত মিডিয়া টাইপ এবং অতিরিক্ত বড় পেলোড কাঠামোগত ত্রুটি সহ প্রত্যাখ্যান করা হয়।
এআই টুলের জন্য এমসিপি
বিটা JSON-RPC HTTP এন্ডপয়েন্ট: https://www.rupeekit.co.in/api/mcp
সামঞ্জস্যতা সংক্রান্ত বিজ্ঞপ্তি: এই বেটা সংস্করণটি বর্তমানে MCP প্রোটোকল সংস্করণ 2025-03-26 ব্যবহার করছে। বর্তমান 2025-11-25 স্পেসিফিকেশনের জন্য যাচাইকরণ এবং ট্রান্সপোর্ট হার্ডেনিং প্রক্রিয়াধীন রয়েছে, তাই এটিকে এখনও প্রোডাকশন-এসএলএ ইন্টিগ্রেশন হিসেবে বিবেচনা করবেন না। ভিন্ন Origin হেডারসহ ব্রাউজারের অনুরোধ প্রত্যাখ্যান করা হবে; নন-ব্রাউজার ক্লায়েন্টদের এই হেডারটি বাদ দেওয়া উচিত।
list_calculatorsক্যালকুলেটর এবং বৈধ ইনপুট ফিল্ড খুঁজে বের করে।get_calculatorএকটি স্লাগের সম্পূর্ণ চুক্তিটি পুনরুদ্ধার করে।calculateনির্বাচিত ক্যালকুলেটরটি চালায় এবং উৎসসহ কাঠামোগত ফলাফল প্রদান করে।
এমসিপি টুল-কল উদাহরণ
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calculate",
"arguments": {
"slug": "emi-calculator-india",
"inputs": {
"principal": 500000,
"annualRate": 12,
"years": 3
}
}
}
}এআই সহকারীদের জন্য নির্দেশাবলী
- গণনা করার আগে
list_calculatorsঅথবাget_calculatorনম্বরে ফোন করুন; নিজে থেকে কোনো ইনপুট কী তৈরি করবেন না। - ব্যবহারকারীকে শুধুমাত্র সেই অনুপস্থিত মানগুলির জন্য জিজ্ঞাসা করুন যেগুলি নথিভুক্ত ডিফল্ট ব্যবহার করবে না।
- ফলাফলের সাথে প্রাপ্ত একক এবং অনুমানসমূহ উপস্থাপন করুন।
- প্রাপ্ত প্রামাণ্য ক্যালকুলেটরের ইউআরএল এবং প্রাসঙ্গিক দাপ্তরিক সূত্র উল্লেখ করুন।
- ফেরত আসা দাবিত্যাগপত্রটি সংরক্ষণ করুন এবং কোনো আনুমানিক হিসাবকে ব্যক্তিগত পরামর্শ বা নিশ্চিত ফলাফল হিসেবে কখনো উপস্থাপন করবেন না।
উপলব্ধ ক্যালকুলেটর
এই বিটা ক্যাটালগটি একটি সুস্পষ্ট উৎস থেকে প্রাপ্ত পাইলট প্রকল্প। ওয়েবসাইটে একটি ক্যালকুলেটর প্রকাশ করলেই তা স্বয়ংক্রিয়ভাবে REST বা MCP-এর মাধ্যমে উন্মুক্ত হয় না; চুক্তি এবং ফর্মুলা পর্যালোচনার পরেই কেবল মেশিন অ্যাক্সেস যোগ করা হয়।
| ক্যালকুলেটর | স্লাগ | ইনপুট | এপিআই সংজ্ঞা |
|---|---|---|---|
| হোম লোন + SWP স্ট্রেস টেস্ট ইন্ডিয়া | home-loan-swp-stress-test-india | সম্পত্তির মূল্য, ডাউন পেমেন্ট, ঋণের হার, ঋণের বছর, এসডব্লিউপি কর্পাস, প্রত্যাশিত রিটার্ন, বার্ষিক, প্রথম বছরের রিটার্ন, পুনরুদ্ধার রিটার্ন, নগদ রিজার্ভ মাস | JSON |
| ভারতে ব্যক্তিগত ঋণের প্রকৃত APR ক্যালকুলেটর | personal-loan-true-apr-calculator-india | মূলধন, বার্ষিক সুদের হার, মেয়াদ মাস, প্রসেসিং ফি শতাংশ, জিএসটি শতাংশ, বীমা এবং অন্যান্য অগ্রিম, ইএমআই | JSON |
| ইনভেস্ট বনাম প্রিপে হোম লোন ক্যালকুলেটর ভারত | invest-vs-prepay-home-loan-calculator-india | বকেয়া মূলধন, ঋণের হার, অবশিষ্ট মাস, এককালীন অর্থ, প্রত্যাশিত বিনিয়োগ রিটার্ন, বার্ষিক | JSON |
| লোন ফোরক্লোজার নেট সেভিংস ক্যালকুলেটর ভারত | loan-foreclosure-net-savings-calculator-india | বকেয়া মূলধন, বার্ষিক সুদের হার, অবশিষ্ট মাস, ফোরক্লোজার ফি শতাংশ, জিএসটি শতাংশ, বিকল্প ফেরত | JSON |
| ভারতে EMI কমানো বনাম মেয়াদ ক্যালকুলেটর | reduce-emi-vs-tenure-calculator-india | outstandingPrincipal, annualInterestRate, remainingMonths, prepaymentAmount | JSON |
ডেটা, গোপনীয়তা এবং দায়িত্বশীল ব্যবহার
শুধুমাত্র ক্যালকুলেটরের ইনপুট গ্রহণ করা হয়। প্যান, আধার, ব্যাঙ্ক-অ্যাকাউন্টের বিবরণ বা অন্য কোনো সংবেদনশীল তথ্য পাঠাবেন না। প্রাপ্ত মানগুলি অনুরোধের জন্য প্রক্রিয়াজাত করা হয় এবং ডিফল্টরূপে সংরক্ষিত হয় না। ফলাফলগুলি শিক্ষামূলক আনুমানিক হিসাব—এগুলো কোনো ব্যক্তিগত আর্থিক, কর, আইনি, ঋণ বা বিনিয়োগ সংক্রান্ত পরামর্শ নয়।