কোটা ও রেট সীমা

FreeMaint API প্রতিটি কোম্পানির জন্য একটি দৈনিক কোটা প্রয়োগ করে, যা UTC মধ্যরাতে রিসেট হয়। সীমা আপনার প্ল্যানের উপর নির্ভর করে; গণনা ও বাকি কলের সংখ্যা রেসপন্স হেডারে দেখানো হয়।

দৈনিক সীমা

• Core, Starter — 0 (API কী-এর জন্য Business প্রয়োজন)
• Business — দৈনিক 5,000 কল (GraphQL এবং এনার্জি ইনজেস্ট এন্ডপয়েন্ট একই কাউন্টার ভাগ করে নেয়)
• Enterprise — দৈনিক 100,000 কল
• On-Premise — সীমাহীন (সীমা = null)

রেসপন্স হেডার

• X-RateLimit-Limit — আপনার প্ল্যানের দৈনিক সীমা
• X-RateLimit-Remaining — আজ বাকি থাকা কল (কোটায় গণ্য প্রতিটি কলে কমে)
• X-RateLimit-Reset — UTC মধ্যরাতের Unix টাইমস্ট্যাম্প (পরবর্তী রিসেট)

যা গণনা হয় না

কেবল /public-api/whoami বিনামূল্যে — এটি আপনার কাউন্টার কমায় না, তাই কোটা খরচ না করেই একটি কী ও তার প্ল্যান যাচাই করা যায়। /api/v1/graphql দিয়ে যাওয়া সবকিছু গণনা করা হয়, whoami কোয়েরিসহ, এবং এনার্জি ইনজেস্ট এন্ডপয়েন্টও তাই।

একটি কল হিসেবে কী গণ্য হয়

গণনা বাড়ে প্রতিটি অপারেশনে, HTTP অনুরোধে নয়। একটি অনুরোধে ৫০টি অ্যালিয়াসযুক্ত মিউটেশন একত্র করলেও ৫০ একক খরচ হয়। তাই একত্র করলে নেটওয়ার্ক যাতায়াত বাঁচে, কোটা নয়। নিয়মিত সিঙ্ক সাশ্রয়ী রাখতে পুরো তালিকা আবার না পড়ে parts(updatedSince: "...") দিয়ে কেবল পরিবর্তনটুকু আনুন।

সীমা পেরিয়ে গেলে

দৈনিক সীমা ছুঁয়ে ফেললে পরবর্তী প্রতিটি কল 'Daily API cap reached' বার্তা দিয়ে প্রত্যাখ্যাত হয়। REST পৃষ্ঠে (/public-api/ping, এনার্জি ইনজেস্ট এন্ডপয়েন্ট) সেটি একটি HTTP 403। GraphQL-এ HTTP স্ট্যাটাস 200 এবং প্রত্যাখ্যান থাকে errors[0].extensions.code = FORBIDDEN-এ, সঙ্গে originalError.statusCode = 403। কাউন্টার 00:00 UTC-তে রিসেট হয়। কোনো নরম সীমা, বার্স্ট ছাড় বা প্রতি-মিনিট উইন্ডো নেই — উইন্ডোটি হলো পুরো দিন।