محدودیت‌ها و اندازه‌ها

تا پلتفرم پایدار بماند، API محدودیت‌هایی بر نرخ درخواست‌ها و اندازه داده‌های ارسالی دارد.

نرخ درخواست

در صورت تجاوز از نرخ مجاز درخواست‌ها، سرور با کد 429 Too Many Requests پاسخ می‌دهد. واکنش درست — تکرار با تأخیر نمایی (backoff): فاصله بین تکرارها را افزایش دهید و درخواست‌ها را به‌صورت انبوه ارسال نکنید. عملیات انبوه را در زمان پخش کنید و از یک توکن به‌صورت متوالی استفاده کنید، نه به‌صورت موازی و انفجاری.

اندازه بدنه درخواست

برای درخواست‌های REST معمولی، اندازه بدنه JSON به 2 MiB محدود است. این برای هر پیکربندی واکنش، مجموعه و تنظیماتی کافی است. اگر بدنه بزرگ‌تر است — عملیات را به قسمت‌ها تقسیم کنید (مثلاً واکنش‌ها را به‌صورت دسته‌ای وارد کنید).

اندازه بدنه هنگام ورودی

اندپوینت‌های ورودی برای بسته‌های بزرگ طراحی شده‌اند و محدودیت‌های جداگانه و بالاتری دارند: تا 64 MiB برای ورودی داده و تا 256 MiB برای ورودی با رسانه پیوست. اگر بسته بزرگ‌تر است — آن را به چند ورودی تقسیم کنید.

تجاوز از محدودیت‌ها

  • تجاوز از نرخ — 429، تکرار با تأخیر.
  • بدنه بزرگ‌تر از حد مجاز — درخواست رد می‌شود (413 یا 400 بسته به اندپوینت)؛ payload را کوچک‌تر کنید یا تقسیم کنید.

بیشتر بخوانید