تفرض واجهة برمجة تطبيقات FreeMaint حصة يومية لكل شركة، ويتم إعادة تعيينها عند منتصف الليل بالتوقيت العالمي المنسق. يعتمد الحد الأقصى على مستواك؛ يتم عرض العدادات والباقي كرؤوس استجابة.
القبعات اليومية
- Core و Starter — 0 (مفتاح API يتطلب Business)
- Business — 5,000 استدعاء/يوم (يتشارك GraphQL ونقطة استقبال بيانات الطاقة العدّاد نفسه)
- Enterprise — 100,000 استدعاء/يوم
- On-Premise — غير محدود (الحد = null)
رؤوس الاستجابة
- X-RateLimit-Limit — الحد الأقصى اليومي لفئتك
- X-RateLimit-Remaining — المكالمات المتبقية اليوم (تتناقص في كل مكالمة محسوبة الحصص)
- X-RateLimit-Reset — الطابع الزمني لنظام Unix عند منتصف الليل بالتوقيت العالمي المنسق (إعادة التعيين التالية)
ما لا يحسب
/public-api/whoami وحده مجاني: فهو لا يُنقص عدّادك، ما يتيح لك التحقق من مفتاح وخطته دون استهلاك الحصة. أما كل ما يمر عبر /api/v1/graphql فيُحتسب، بما في ذلك استعلام whoami، وكذلك نقطة استقبال بيانات الطاقة.
ما الذي يُحتسب استدعاءً واحداً
يزداد العدّاد لكل عملية، لا لكل طلب HTTP. فتجميع 50 عملية تعديل بأسماء مستعارة في طلب واحد يستهلك 50 وحدة كاملة. التجميع إذن يوفّر رحلات الشبكة، لا الحصة. ولتبقى المزامنة الدورية زهيدة، اجلبوا ما تغيّر فقط عبر 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. لا يوجد حد مرن ولا هامش اندفاع ولا نافذة بالدقيقة — النافذة هي اليوم.
نصيحة
مقالات ذات صلة
هل كانت هذه الصفحة مفيدة؟