StreamLive Proקריאה ל-API של StreamLive Pro נכשלת: קודי שגיאה ופתרונות
שגיאות ה-API של StreamLive Pro בהסבר פשוט: מפתח לא תקין או שפג, הרשאה חסרה, מגבלת מסלול, 409, 429 ו-5xx, וגם קודי המפתחות הישנים באותיות גדולות.
רוב הקריאות שנכשלות ל-API נכשלות בגלל המפתח, לא בגלל הבקשה: טעות בהעתקה, מפתח שבוטל או שפג, מפתח בלי ההרשאה לנקודת הקצה הזו, או מסלול שכבר לא כולל מפתחות API. לכל שגיאה מ-https://streamlivepro.io/api/v1 יש אותו מבנה, כך שקוראים את ה-type ואת ה-code ומתקנים את הדבר הנכון. ChatGPT ו-Claude מקבלים את אותם קודים, ובדרך כלל מסבירים לכם את ההודעה במילים פשוטות.
{ "error": { "type": "permission_error", "code": "plan_limit",
"message": "The plan on this account allows up to 3 channels at once; 5 were chosen.",
"request_id": "req_...", "doc_url": "https://streamlivepro.io/developers#errors" } }
בחלק מהשגיאות יש גם info_url, קישור להסבר נוסף. ההודעה כתובה לבני אדם, אז כדאי לרשום אותה ביומן כמו שהיא.
תסמין, סיבה, פתרון
| סטטוס וקוד | סיבה אפשרית | מה עושים |
|---|---|---|
| 401 missing_credentials | אין כותרת Authorization, או שהיא לא בצורה Bearer ואז המפתח | שולחים Authorization: Bearer slp_... |
| 401 invalid_api_key | טעות הקלדה, מפתח שבוטל, או ערך שהוא לא מפתח של StreamLive Pro | מעתיקים את המפתח שוב. אם הוא בוטל, יוצרים חדש |
| 401 expired_api_key | עבר תאריך התפוגה של המפתח | יוצרים מפתח חדש בהגדרות, אבטחה, "אפליקציות מחוברות ו-API" |
| 401 invalid_token | טוקן OAuth שפג או שלא שייך ל-API הזה | מחדשים את הטוקן, או מתחברים שוב |
| 403 insufficient_scope | למפתח אין את ההרשאה שנקודת הקצה צריכה | יוצרים מפתח עם ההרשאה. בטבלת נקודות הקצה רואים איזו |
| 403 plan_limit | מפתחות API לא כלולים במסלול, או שהגעתם למגבלת מסלול (ערוצים בבת אחת, שורטס, ניסיון) | קוראים את ההודעה. ראו /pricing |
| 403 account_blocked | החשבון חסום | כותבים לתמיכה |
| 403 not_available | ה-API עוד לא פתוח לחשבון הזה | כותבים לתמיכה |
| 400 invalid_arguments | שדה חסר, ארוך מדי, מסוג לא נכון, או לא מוכר | מתקנים את השדה שההודעה מציינת |
| 400 invalid_body | הגוף הוא לא אובייקט JSON | שולחים JSON עם Content-Type: application/json |
| 404 not_found או unknown_endpoint | המזהה לא בחשבון הזה, או שהנתיב לא קיים | בודקים את קידומת המזהה ואת הנתיב ב-openapi.json |
| קודי 409 | המצב לא מאפשר את זה עכשיו | קוראים שוב את האובייקט. הרשימה למטה |
| 422 idempotency_key_reused | ה-Idempotency-Key שימש לבקשה אחרת | מפתח חדש לכל פעולה |
| 429 rate_limited | יותר מדי קריאות בחלון הזמן | מחכים את מספר השניות שב-Retry-After |
| 501 not_implemented | נקודת קצה מתוכננת (העלאות, חיבור מצלמה) | עוד לא זמינה |
| 500, 502, 503 | בעיה אצלנו, או שירות שלא ענה בזמן | מנסים שוב עם אותו Idempotency-Key אחרי הפסקה |
קודי בקשה שתפגשו
| קוד | מה הוא אומר |
|---|---|
| destinations_required, unknown_destination, too_many_destinations | אין יעד, מזהה שלא בחשבון הזה, או יותר מ-30 |
| destination_needs_attention | צריך לחבר את הערוץ מחדש קודם: חיבור מחדש של ערוץ |
| not_live_capable | הערוץ לא יכול לשדר חי. אינסטגרם וטיקטוק צריכים מפתח LIVE שמור |
| publish_in_app | פוסטים לטיקטוק, לפינטרסט ולוואטסאפ נעשים במסך הפרסום |
| youtube_privacy_required | יעד YouTube צריך public, unlisted או private |
| invalid_time, time_in_past, time_too_far | לא ISO 8601 עם אזור זמן, פחות מדקה קדימה, או יותר משנה קדימה |
| title_required, nothing_to_change, invalid_id, invalid_privacy | כותרת חסרה, שינוי ריק, קידומת מזהה שגויה, ערך פרטיות שגוי |
| unsupported_language, too_many_languages | תרגום כתוביות מחוץ ל-19 הקודים הנתמכים, או יותר מ-3 |
| streaming_software_not_included | מפתח שידור בניסיון, שבו משדרים מהסטודיו בדפדפן |
| already_live, not_live, live_ended, has_history | שינוי שידור שבאוויר, סיום שידור שלא באוויר, שינוי שידור שהסתיים, ביטול שידור ששודר (409) |
| no_recording, file_not_ready, key_unavailable | אין הקלטה לחתוך ממנה שורטס, אין קובץ מוכן בפורמט הזה, אין מפתח לשידור הזה (409) |
שלבים
- קוראים את הסטטוס ואת הקוד. 401 עוסק במפתח עצמו. 403 במה שהמפתח או המסלול מאפשרים. 400 ו-409 בבקשה.
- בודקים את המפתח לבד. קוראים ל-GET /me. אם זה נכשל, הבעיה במפתח או במסלול, לא בבקשה שלכם.
- בודקים את ההרשאות של המפתח. למפתח יש את ההרשאות שסומנו כשיצרתם אותו. אם חסרה ההרשאה שצריך, יוצרים מפתח חדש איתה ומבטלים את הישן.
- בודקים את המסלול. מפתחות API הם חלק ממסלול Studio. אם המסלול השתנה, המפתחות הקיימים מפסיקים לעבוד עם plan_limit עד שהמסלול חוזר.
- בודקים את המזהים. לכל מזהה צריכה הקידומת שלו: live_, clip_, post_, dest_. מזהי יעדים מקבלים מ-GET /connections.
- שומרים את ה-Request-Id. הוא נחוץ לתמיכה.
מפתחות ישנים וקודים באותיות גדולות
מפתחות שנוצרו לפני השיטה הנוכחית מתחילים ב-sl_. כשמפתח כזה פונה ישירות למסלולים של האתר ולא ל-/api/v1, השגיאות מגיעות עם קודים באותיות גדולות: API_KEY_INVALID, API_KEY_REVOKED ו-API_KEY_EXPIRED (401); ACCOUNT_BLOCKED; UPGRADE_REQUIRED, "API access requires the Studio plan" (403); SCOPE_INSUFFICIENT, "This API key is read-only"; API_KEY_SCOPE_PATH, "This endpoint is not available to API keys"; ו-API_KEY_NOT_ALLOWED למסלולי ניהול. הפתרון זהה למה שלמעלה, והדרך הפשוטה היא לעבור ל-/api/v1 עם מפתח slp_ חדש.
מתי פונים לתמיכה
כותבים ל[email protected] כשמקבלים 403 account_blocked או not_available, או כש-500, 502 או 503 נמשכים יותר מכמה דקות. שולחים את ה-request_id, השעה, השיטה והנתיב, והסטטוס. אף פעם לא את מפתח ה-API עצמו.
עוד: תיעוד ה-REST API, מפתחות API למפתחים.
שאלות נפוצות
למה ה-API של StreamLive Pro אומר invalid_api_key?
יש טעות במפתח, הוא בוטל, או שהוא לא מפתח של StreamLive Pro. מעתיקים שוב, או יוצרים מפתח חדש אם הוא בוטל או אבד.
מה זה insufficient_scope?
למפתח אין את ההרשאה שנקודת הקצה צריכה, למשל read:stream_keys לנקודת ה-ingest. יוצרים מפתח עם ההרשאה הזו.
המפתח עבד אתמול והיום מחזיר plan_limit. למה?
מפתחות API הם חלק ממסלול Studio. אם המסלול השתנה או נגמר, המפתחות מפסיקים לעבוד עד שהמסלול כולל אותם שוב.
כדאי לנסות שוב 409?
לא כמו שהוא. 409 אומר שהשידור או הפוסט במצב שלא מאפשר את הפעולה. קוראים אותו שוב ומחליטים.
מה שולחים לתמיכה על שגיאת API?
את ה-request_id, השעה, השיטה והנתיב, וקוד הסטטוס. אף פעם לא את המפתח.
המשך קריאה
התזמון של פוסט או שידור נדחה: התאריך אחרי סוף הניסיון או תקופת המסלול, אין לחשבון מסלול פעיל, TikTok מסומן, או שהשעה כבר עברה.
מגבלות קצב ב-API, ניסיונות חוזרים ו-Idempotency-Keyמגבלות הקצב של ה-API של StreamLive Pro לכל מפתח, לכל חשבון, לכתיבה ולפרסום; כותרות RateLimit, מה עושים ב-429, וניסיון חוזר בטוח עם Idempotency-Key.
עמוד הפייסבוק שלי לא מופיע ברשימהעמוד פייסבוק חסר אחרי שחיברתם את פייסבוק? בדרך כלל הוא לא סומן במסך האישור של פייסבוק. איך מוסיפים אותו בחיבור מחדש, ומה עוד יכול לגרום לזה.
מה ChatGPT ו-Claude לא יכולים לעשות ב-StreamLive Proהגבולות של ChatGPT ו-Claude ב-StreamLive Pro, עם הסיבה לכל אחד ומה עושים במקום: חיבור רשתות, פוסטים לטיקטוק, העלאות, אישורים ועוד.
רוצים לנסות? 7 ימי ניסיון, בלי כרטיס אשראי.
להתחיל בחינם