מגבלות וגדלים

כדי שהפלטפורמה תישאר יציבה, ל-API יש מגבלות על תדירות הבקשות ועל גודל הנתונים המועברים.

תדירות בקשות

כאשר חורגים מתדירות הבקשות המותרת, השרת מגיב בקוד 429 Too Many Requests. התגובה הנכונה היא ניסיון חוזר עם השהייה אקספוננציאלית (backoff): הגדילו את ההפסקה בין ניסיונות ואל תשלחו בקשות בזרם צפוף. פזרו פעולות מסיביות בזמן ועשו שימוש חוזר בטוקן אחד ברציפות, לא בהתפרצויות מקביליות.

גודל גוף בקשה

לבקשות REST רגילות, גודל גוף ה-JSON מוגבל ל2 MiB. זה מספיק לכל הגדרות תגובות, קולקציות והגדרות. אם הגוף גדול יותר — פצלו את הפעולה לחלקים (לדוגמה, ייבאו תגובות באצוות).

גודל גוף לייבוא

ה-endpoint של ייבוא מתוכננים לחבילות גדולות ויש להם מגבלות נפרדות גבוהות יותר: עד 64 MiB לייבוא נתונים ועד 256 MiB לייבוא עם מדיה מוטמעת. אם החבילה גדולה יותר — חלקו לכמה ייבואים.

חריגה ממגבלות

  • חרגתם ממגבלת התדירות — 429, ניסיון חוזר עם השהייה.
  • הגוף גדול מהמותר — הבקשה נדחית (413 או 400 בהתאם ל-endpoint); הקטינו או פצלו את המטען.

המשך