StreamLive Pro

מגבלות קצב ב-API, ניסיונות חוזרים ו-Idempotency-Key

מגבלות הקצב של ה-API של StreamLive Pro לכל מפתח, לכל חשבון, לכתיבה ולפרסום; כותרות RateLimit, מה עושים ב-429, וניסיון חוזר בטוח עם Idempotency-Key.

עודכן 5 בנובמבר 2026 · 3 דק׳ קריאה

ה-API של StreamLive Pro מגביל כמה מהר מפתח אחד וחשבון אחד יכולים לקרוא לו, כדי שלולאה בקוד של מישהו לא תציף את הערוצים שלכם. המגבלות: 120 קריאות בדקה לכל מפתח או חיבור, 240 בדקה לכל חשבון בכל המפתחות יחד, 30 פעולות כתיבה בדקה לחשבון, ו-20 פרסומים בשעה לחשבון. כל תשובה אומרת לכם בכותרות איפה אתם עומדים, וקריאה שנדחתה אומרת כמה שניות לחכות. בפעולות כתיבה שולחים כותרת Idempotency-Key, כדי שניסיון חוזר אף פעם לא יעשה את אותו דבר פעמיים.

מפתחות, הרשאות ורשימת נקודות הקצה: מפתחות API למפתחים. אותן פעולות ככלים של עוזרים: רשימת הכלים.

המגבלות

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

הכותרות בכל תשובה

כשעוברים מגבלה, התשובה היא 429 עם type בשם rate_limit_error ו-code בשם rate_limited, והודעה כמו "Rate limit reached. Try again in 12 seconds."

שלבים

1. קוראים את RateLimit-Remaining. כשהמספר יורד, מאטים לפני שמגיעים לאפס.
2. ב-429 מחכים. ממתינים את מספר השניות שב-Retry-After ואז מנסים שוב. לא מנסים מיד בלולאה.
3. שולחים Idempotency-Key בכל כתיבה. ערך ייחודי לכל פעולה, 8 עד 100 תווים של אותיות, ספרות, קו תחתון, נקודה, נקודתיים או מקף. למשל publish-clip_123-2026-11-05.
4. על שגיאת שרת מנסים שוב עם אותו מפתח. אחרי timeout, 500, 502 או 503, מחכים קצת ושולחים בדיוק את אותה בקשה עם אותו Idempotency-Key. מכפילים את ההמתנה בכל פעם.
5. רוב תשובות ה-4xx לא שולחים שוב כמו שהן. 400, 401, 403 או 404 ייכשלו שוב עד שמתקנים את הבקשה. 409 אומר שהמצב השתנה: קוראים שוב את האובייקט ואז מחליטים.
6. שומרים את ה-Request-Id. רושמים אותו ביומן עם כל שגיאה. לפיו התמיכה מוצאת את הבקשה.

איך Idempotency-Key עובד

• הוא חל על POST, PATCH ו-DELETE.
• אחרי שבקשה עם מפתח הצליחה, במשך 24 שעות אותו מפתח עם אותה בקשה מחזיר את התשובה הראשונה, עם אותו סטטוס, במקום לבצע שוב. בתשובה מופיעה הכותרת Idempotent-Replayed: true. בקשה שנכשלה לא נשמרת, ולכן אפשר לתקן את הסיבה ולנסות שוב עם אותו מפתח.
• אותו מפתח עם בקשה אחרת (נתיב אחר או שדות אחרים) נדחה עם 422 idempotency_key_reused.
• מפתח בפורמט לא נכון נדחה עם 400 invalid_idempotency_key.
• המפתחות נשמרים לכל חשבון בנפרד, כך ששני חשבונות יכולים להשתמש באותו ערך.

זה הכי חשוב ב-POST /posts, שמפרסם מיד בלי תצוגה מקדימה, וב-POST /lives. בלי הכותרת, ניסיון חוזר אחרי timeout יכול לפרסם את אותו שורט פעמיים.

curl -X POST https://streamlivepro.io/api/v1/posts \
  -H "Authorization: Bearer slp_..." -H "Content-Type: application/json" \
  -H "Idempotency-Key: publish-clip_7f3a-2026-11-05" \
  -d '{"clip_id":"clip_...","destination_ids":["dest_..."],"title":"Five tips","youtube_privacy":"public"}'

מה יכול להשתבש

מבנה השגיאות והקודים הראשונים שתפגשו: מפתחות API למפתחים. מגבלות המסלול שחלות בנוסף: מגבלות מסלול והודעות שדרוג.

שאלות נפוצות

מה מגבלת הקצב של ה-API של StreamLive Pro?

120 קריאות בדקה לכל מפתח, 240 בדקה לכל חשבון, 30 פעולות כתיבה בדקה לחשבון ו-20 פרסומים בשעה לחשבון.

מה הקוד שלי צריך לעשות ב-429?

לחכות את מספר השניות שבכותרת Retry-After, ואז לשלוח את הבקשה שוב.

כמה זמן Idempotency-Key נזכר?

24 שעות אחרי בקשה שהצליחה. אותו מפתח עם אותה בקשה מחזיר את התשובה הראשונה במקום לחזור על הפעולה.

ChatGPT ו-Claude נספרים באותן מגבלות?

לכל חיבור של עוזר יש מגבלה משלו, וכולם נספרים במגבלות של החשבון יחד עם מפתחות ה-API שלכם.

אפשר לבקש מגבלות גבוהות יותר?

היום המגבלות זהות לכל החשבונות. אם הן חוסמות שימוש אמיתי, כתבו ל[email protected] ותארו מה אתם בונים.

המשך קריאה