לדף הבית / חדשות

מגבלות קצב לכל מפתח API ב-n8n: אוטומציות שלא נתקעות וניסיונות חוזרים בלי כפילויות

אם סוכן AI או סקריפט פונים ל-n8n שלכם דרך ה-API הציבורי, כדאי לעדכן ל-n8n 2.47.0 ולהפעיל מגבלות קצב לכל מפתח, כדי שלולאה אחת שיצאה משליטה לא תקפיא את כל שאר האוטומציות. בכל קריאה שיוצרת רשומות, כמו לידים, חשבוניות או הזמנות, שלחו מפתח idempotency, וכך ניסיון חוזר לא ייצור כפילות.

הצוות של n8n הוסיף מגבלות לפי מפתח API בכל התוכניות, גם ב-Cloud וגם ב-self-hosted, עם תקרה נפרדת לקריאה ולכתיבה. לקוח שמגיע לתקרה מקבל תשובת 429 עם כותרת Retry-After שאומרת מתי לנסות שוב. מפתחות idempotency זמינים כבר מגרסה 2.45.0: כשבקשת POST מצליחה, המערכת שומרת את התשובה ל-12 שעות, וניסיון חוזר עם אותו מפתח ואותו תוכן מקבל את התשובה השמורה במקום לפתוח רשומה שנייה.

מה זה משנה לעסק קטן

תצורה שאני פוגש הרבה: מערכת אחת, סוכן Claude שפותח משימות או רשומות ב-CRM דרך ה-API, ותהליכים שפונים לאותה מערכת עצמה. נניח מרפאה שמסנכרנת את רשימת המטופלים, או משרד עורכי דין שמעלה תיקים ללקוחות. כל node רץ פעם אחת לכל פריט, כך שרשימה של 1,000 אנשי קשר היא בערך 1,000 בקשות בבת אחת. עד עכשיו פתרו את זה עם מגביל קצב שנבנה בבית, ועכשיו זו פשוט הגדרה.

הסתייגות אחת: המגבלות כבויות כברירת מחדל, וה-node של n8n וה-node של HTTP Request פשוט נכשלים כשהם מקבלים 429. צריך להוסיף להם Batching. הדוגמה של n8n היא 5 פריטים בשנייה, כלומר 300 בקשות בדקה, וזה נשאר מתחת לכל מגבלות ברירת המחדל. Retry On Fail לא פותר את זה, כי הוא מחכה לכל היותר 5 שניות ולעתים קרובות מנסה שוב באותו חלון זמן.

למה זה חשוב: לידים או הזמנות כפולים ומערכת שנתקעת הן שתי התקלות שבעל עסק מרגיש ראשונות. הפעילו את המגבלות, הוסיפו Batching ל-nodes שמעבדים כמויות, ותנו לכל סוכן מפתח API משלו, כדי שתוכלו לראות מי מהם מתנהג לא כמו שצריך.

מקור: n8n Blog