مرجع توسعه‌دهندگان

EFARS API

محدودیت نرخ و retry

کنترل هم‌زمانی، زمان انتظار و درخواست‌های تکراری.

راهنمای اتصال مشتریان
curl · Python · JavaScript

محدودیت را از پاسخ بخوانید

نرخ مجاز به حساب، گروه، مدل و سرویس وابسته است؛ یک عدد ثابت برای همه کلیدها فرض نکنید. در 429، هدر Retry-After را در صورت وجود بررسی کنید. نبود این هدر به معنی نبود محدودیت نیست. محدودیت context، سقف خروجی و محدودیت نرخ مفاهیم جدا هستند.

تلاش مجدد محدود

  • ابتدا نوع خطا را تشخیص دهید؛ پارامتر یا مجوز نامعتبر را با retry اصلاح نمی‌کنید.
  • برای خطاهای گذرا از تأخیر افزایشی با jitter، سقف تأخیر و حداکثر تعداد تلاش استفاده کنید.
  • درخواست‌های یک کاربر را صف‌بندی و هم‌زمانی کل برنامه را محدود کنید.
  • timeout را بر اساس کاربرد تعیین و انصراف کاربر را تا اتصال سرور منتقل کنید.

هزینه و اجرای تکراری

یک POST دوباره می‌تواند اجرای تازه و هزینه تازه داشته باشد. پشتیبانی عمومی از Idempotency-Key یا تضمین اجرای دقیقاً یک‌باره را فرض نکنید. در عملیات دارای اثر جانبی ابزارها، شناسه کار در برنامه خود داشته باشید و پیش از اجرای دوباره ابزار، وضعیت کار را بررسی کنید.