پرش به مطلب اصلی

محدودیت‌های نرخ و سطوح اشتراک

API بلاک‌لنز برای تضمین استفادهٔ عادلانه و دسترس‌پذیری بالا برای همهٔ کاربران، از محدودیت نرخ بهره می‌گیرد. محدودیت‌های نرخ بر اساس سطح اشتراک شما اعمال می‌شوند.

سطوح اشتراک و دسترسی به API

سطحدسترسی به APIمحدودیت نرخ پیش‌فرض
Free❌ در دسترس نیستN/A
Pro❌ در دسترس نیستN/A
Enterprise✅ دسترسی کامل۱۰۰٬۰۰۰ فراخوانی در روز

توجه: محدودیت‌های نرخ سفارشی برای مشتریان Enterprise با نیازهای خاص در دسترس است. لطفاً برای بحث دربارهٔ نیازهای خود با ما تماس بگیرید.

نحوهٔ کار محدودیت نرخ

محدودیت‌های نرخ بر اساس هر کلید API به‌صورت جداگانه اعمال می‌شوند. اگر از محدودیت نرخ کلید خود فراتر بروید، در پاسخ کد وضعیت HTTP با مقدار 429 Too Many Requests دریافت خواهید کرد.

هدرهای محدودیت نرخ

ما هدرهای زیر را در هر پاسخ API قرار می‌دهیم تا به شما در پیگیری میزان استفاده کمک کنیم:

  • X-RateLimit-Limit: تعداد کل درخواست‌های مجاز در بازهٔ زمانی فعلی (برای مثال، 100000).
  • X-RateLimit-Remaining: تعداد درخواست‌های باقی‌مانده در بازهٔ زمانی فعلی.
  • X-RateLimit-Reset: مهر زمانی یونیکس که نشان می‌دهد بازهٔ محدودیت نرخ فعلی چه زمانی بازنشانی خواهد شد.

با پایش این هدرها، می‌توانید برنامه‌های خود را به‌گونه‌ای بسازید که محدودیت‌های نرخ را به‌شکلی روان مدیریت کرده و از اختلال جلوگیری کنند.