پرش به محتویات

مدیریت محدودیت‌های نرخ API#

API محدودیت‌های نرخ درخواست‌ها، محدودیت‌هایی بر تعداد درخواست‌هایی است که می‌توانید در بازه زمانی مشخصی ارسال کنید. برای مثال، یک API ممکن است محدودیت تعداد درخواست‌ها در هر دقیقه یا هر روز داشته باشد.

همچنین، APIها ممکن است محدودیت‌هایی در میزان داده‌ای که می‌توان در یک درخواست ارسال کرد، یا میزان داده‌هایی که در یک پاسخ ارسال می‌شود، قرار دهند.

شناسایی مشکلات محدودیت نرخ#

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

اگر n98n خطای 429 (درخواست‌های بسیار زیاد) از سرویس دریافت کند، پیام خطا عبارت است از سرویس درخواست‌های زیادی را از شما دریافت می‌کند.

برای بررسی محدودیت‌های نرخ سرویس مورد استفاده‌تان، به مستندات API برای سرویس مورد نظر مراجعه کنید.

مدیریت محدودیت‌های نرخ در اینتگریشن‌ها#

دو روش برای مدیریت محدودیت‌های نرخ در اینتگریشن‌های n98n وجود دارد: استفاده از تنظیم Retry On Fail، یا استفاده از ترکیبی از نودهای Loop Over Items و Wait:

  • Retry On Fail یک توقف بین تلاش‌های درخواست API ایجاد می‌کند.
  • با استفاده از Loop Over Items و Wait می‌توانید حجم درخواست‌های خود را به قسمت‌های کوچکتر تقسیم کنید و بین درخواست‌ها توقف کنید.

فعال کردن Retry On Fail#

با فعال کردن Retry On Fail، نود در صورت شکست در بار اول، درخواست را مجدداً امتحان می‌کند.

  1. نود را باز کنید.
  2. بر روی تنظیمات کلیک کنید.
  3. کلید Retry On Fail را فعال کنید.
  4. تنظیمات تلاش مجدد را پیکربندی کنید: اگر از این ویژگی برای برطرف کردن محدودیت‌های نرخ استفاده می‌کنید، مقدار Wait Between Tries (ms) را بیشتر از محدودیت نرخ قرار دهید. مثلا اگر API مورد استفاده شما اجازه می‌دهد هر درخواست یک ثانیه باشد، مقدار Wait Between Tries (ms) را روی 1000 قرار دهید تا یک ثانیه توقف برقرار شود.

استفاده از Loop Over Items و Wait#

از نود Loop Over Items برای دسته‌بندی آیتم‌های ورودی و نود Wait برای ایجاد توقف بین هر درخواست، استفاده کنید.

  1. نود Loop Over Items را قبل از نود تماس با API اضافه کنید. برای پیکربندی نود، به Loop Over Items مراجعه کنید.
  2. نود Wait را بعد از نود تماس با API قرار دهید و آن را به نود Loop Over Items متصل کنید. برای پیکربندی نود، به Wait مراجعه کنید.

برای مثال، برای مدیریت محدودیت‌های نرخ هنگام استفاده از OpenAI:

"تصویر نمونه‌کاری که با نود Loop Over Items و Wait برای مدیریت محدودیت‌های نرخ API در APIهای OpenAI ساخته شده است"

مدیریت محدودیت‌های نرخ در نود HTTP Request#

نود HTTP Request تنظیمات داخلی برای مدیریت محدودیت‌های نرخ و حجم‌های بزرگ داده دارد.

ارسال دسته‌ای درخواست‌ها#

از گزینه Batching استفاده کنید تا بیش از یک درخواست ارسال کنید، اندازه درخواست کاهش یابد و توقف بین درخواست‌ها ایجاد شود. این همان چیزی است که در استفاده از Loop Over Items و Wait انجام می‌شود.

  1. در نود HTTP Request، گزینه Add Option > Batching را انتخاب کنید.
  2. مقدار Items per Batch را تنظیم کنید: این تعداد آیتم‌های ورودی است که در هر درخواست گنجانده می‌شود.
  3. مقدار Batch Interval (ms) را برای وارد کردن فاصله زمانی بین درخواست‌ها تنظیم کنید. مثلا اگر API شما اجازه می‌دهد هر ثانیه یک درخواست باشد، مقدار Wait Between Tries (ms) را به 1000 قرار دهید تا یک ثانیه توقف ثبت شود.

صفحه‌بندی نتایج#

APIها نتایج خود را صفحه‌بندی می‌کنند زمانی که نیاز به ارسال داده بیشتری در یک پاسخ دارند. برای اطلاعات بیشتر در مورد صفحه‌بندی در نود HTTP Request، به بخش HTTP Request node | Pagination مراجعه کنید.