הגבלות קצב

כל תגובה מוצלחת, וכן תגובות שגיאה של חריגה ממכסה (403) או קצב פרץ (429), כוללות כותרות סטנדרטיות המתארות את מצב המכסה שלכם.

כותרות תגובה

X-RateLimit-Limit: 200
X-RateLimit-Remaining: 187
X-RateLimit-Reset: 1769889600

# On 403 (quota_exhausted) / 429 (rate_limited) responses only:
Retry-After: 43200

איפוס מכסה חודשית

המכסה החודשית מתאפסת מדי חודש קלנדרי, ב-01 לחודש בשעה 00:00 לפי שעון ישראל (Asia/Jerusalem). השתמשו ב-X-RateLimit-Reset (חותמת Unix) כדי לחשב את מועד האיפוס המדויק בכל אזור זמן.

מה נחשב "קריאה"?

כל בקשת HTTP אחת נספרת כקריאה אחת כנגד המכסה — ללא קשר לגודל התוכן שבתגובה. לדוגמה, POST /basket/compare/ עם 20 פריטים בעגלה עדיין נספר כקריאה אחת בלבד, לא 20.

מגבלות פרץ (burst)

בנוסף למכסה החודשית, כל תוכנית מוגבלת גם בקצב בקשות לשנייה ולדקה, כדי למנוע עומס פתאומי:

חריגה ממגבלת הפרץ מחזירה 429 עם { "error": { "code": "rate_limited" } } וכותרת Retry-After.