מפתחות API למפתחים: יצירה, שימוש וביטול

מפתחות API של StreamLive Pro למפתחים: יוצרים מפתח במסלול Studio, בוחרים הרשאות ותוקף, קוראים ל-REST API בכתובת /api/v1 ומבטלים בבטחה.

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

מפתח API מאפשר לקוד שלכם לעבוד עם חשבון StreamLive Pro: לראות ולתזמן שידורים, לקרוא את הצ'אט של השידור, לחתוך שורטס מהקלטה, לפרסם אותם ולקרוא אנליטיקה. המפתחות כלולים במסלול Studio. יוצרים מפתח בהגדרות, תחת אבטחה, באזור "אפליקציות מחוברות ו-API". המפתח מוצג פעם אחת בלבד, ושולחים אותו כ-Bearer token לכתובת https://streamlivepro.io/api/v1 . מי שרוצה רק ש-ChatGPT או Claude יעבדו עם החשבון לא צריך מפתח: החיבור הזה כלול בכל מסלול, ראו שימוש ב-StreamLive Pro מתוך ChatGPT ו-Claude.

לפני שמתחילים

מסלול Studio. במסלולים אחרים כרטיס המפתחות מציג "מפתחות API כלולים במסלול Studio." ואי אפשר ליצור מפתח. הפרטים ב/pricing.
מקום בטוח למפתח. מפתח מוצג פעם אחת בלבד, ואצלנו נשמר רק גיבוב (hash) שלו. שומרים אותו במנהל סודות או במשתנה סביבה, אף פעם לא בקוד משותף או בדף אינטרנט.
לדעת מה צריך. לכל מפתח יש הרשאות משלו. נותנים למפתח רק את מה שהתוכנה שלו משתמשת בו.
תיאור ה-API. התיאור המלא, בפורמט שמכונה קוראת, נמצא ב-https://streamlivepro.io/api/v1/openapi.json . ה-API מסומן שם כגרסת בטא, אז קוראים אותו לפני שבונים.

שלבים

פותחים את הגדרות ה-API. בוחרים הגדרות, אחר כך אבטחה, ואז "אפליקציות מחוברות ו-API".
לוחצים "מפתח חדש". מתחת ל"מפתחות API" נפתח טופס קצר.
נותנים שם. לדוגמה שם התוכנה או השרת שישתמשו בו, כדי שתדעו בהמשך איזה מפתח לבטל.
בוחרים הרשאות. מסמנים רק את מה שהתוכנה צריכה, לפי הטבלה למטה. צפייה בפרטי החשבון כלולה תמיד. צפייה במפתח השידור לא מסומנת כברירת מחדל ומסומנת "רגיש".
בוחרים תוקף. 90 יום (ברירת המחדל), 30 יום, שנה, או "ללא". מפתח שפג לבד מצמצם את הנזק אם הוא דלף.
יוצרים ומעתיקים. לוחצים "יצירה". המפתח, שמתחיל ב-slp_, מוצג פעם אחת. מעתיקים, שומרים ולוחצים "סיום".
קוראים ל-API. שולחים את הכותרת Authorization: Bearer ואחריה המפתח, לכתובת https://streamlivepro.io/api/v1 . בדיקה ראשונה: GET /me מחזיר את שם החשבון, המסלול והשימוש החודש.
מבטלים כשמסיימים. באותה רשימה לוחצים "ביטול מפתח" ליד המפתח. קריאות איתו מפסיקות לעבוד מיד.

מסך ההגדרות (חשבון בדיקה).

הרשאות

הרשאה	מה מפתח איתה יכול לעשות
read:account	לראות את שם החשבון, המסלול והשימוש החודשי (תמיד פעיל)
read:streams	לראות את השידורים, הערוצים המחוברים ומצב החיבורים
write:streams	לתזמן, לערוך, לבטל ולסיים שידורים
read:clips	לראות את השורטס שנחתכו מההקלטות
write:clips	לחתוך שורטס חדשים מהקלטה שלכם
publish	לפרסם ולתזמן פוסטים בערוצים המחוברים
read:analytics	לראות סיכומי ביצועים
read:comments	לקרוא את הצ'אט של השידורים שלכם
read:stream_keys	לראות את מפתח השידור. מי שמחזיק בו יכול לשדר בשמכם

נקודות קצה

שיטה ונתיב	מה זה עושה
GET /me	חשבון, מסלול ושימוש
GET /connections	הערוצים המחוברים ומצבם
GET /readiness	מה עוד חסר לפני שעולים לשידור, לפי הסדר
GET /lives, GET /lives/{id}	רשימת שידורים, שידור אחד
POST /lives	הכנת שידור, או תזמון כששולחים שעת התחלה
PATCH /lives/{id}	שינוי שידור
DELETE /lives/{id}	ביטול שידור מתוזמן
POST /lives/{id}/end	סיום שידור
GET /lives/{id}/chat	הצ'אט של השידור
GET /lives/{id}/ingest	פרטי הקליטה. המפתח עצמו רק עם read:stream_keys ו-reveal=true
GET /clips, POST /clips	רשימת שורטס, חיתוך שורטס מהקלטה
GET /posts, POST /posts, GET, PATCH, DELETE /posts/{id}	רשימת פוסטים, פרסום שורט, קריאת פוסט, שינוי או ביטול פוסט מתוזמן
GET /analytics/summary	תוצאות לתקופה, עם התקופה הקודמת להשוואה
GET /podcasts/feeds	מצב פיד הפודקאסט
GET /help/search	חיפוש במרכז העזרה

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

כללים שמגנים עליכם

קריאת API היא החלטה. ב-ChatGPT או ב-Claude העוזר מציג תצוגה מקדימה ושואל לפני פרסום, סיום או ביטול. דרך ה-API, בקשת POST או DELETE ששלחתם היא ההחלטה, בלי תצוגה מקדימה. בודקים על שידור מתוזמן שאפשר לבטל.
ניסיון חוזר בלי כפילויות. שולחים כותרת Idempotency-Key (8 עד 100 תווים) ב-POST, PATCH ו-DELETE. אותו מפתח בתוך 24 שעות מחזיר את התשובה הראשונה במקום לבצע שוב. אותו מפתח עם תוכן אחר נדחה עם 422.
מגבלת קצב. כל תשובה כוללת את הכותרות RateLimit-Limit, ‏RateLimit-Remaining ו-RateLimit-Reset, ו-Retry-After כשעוברים את המגבלה.
מגבלות המסלול חלות. כל קריאה רצה עם המגבלות של החשבון, בדיוק כמו באתר.
פוסטים ל-TikTok ול-Pinterest נעשים באפליקציה על ידי אדם, לא דרך ה-API.
מגבלות על מפתחות. עד 20 מפתחות פעילים לחשבון, ויש גם מגבלת קצב על יצירת מפתחות.
מפתח הוא לא מושב בצוות. אנשים שעובדים בלוח הבקרה מקבלים גישה משלהם: הוספת חברי צוות לחשבון. פרטי המסלולים: חבילות, חיוב ומגבלות.

שגיאות

שגיאות חוזרות כ-error עם type, ‏code, ‏message, ‏request_id ו-doc_url. אלה שתפגשו קודם:

סטטוס וקוד	משמעות
401 missing_credentials	אין כותרת Authorization
401 invalid_api_key	המפתח שגוי או בוטל
401 expired_api_key	פג תוקף המפתח. יוצרים חדש בהגדרות
403 plan_limit	מפתחות API לא כלולים במסלול של החשבון
404 unknown_endpoint	אין נתיב כזה. בודקים ב-openapi.json

שומרים את ה-request_id כשכותבים ל[email protected]. לעולם לא שולחים את המפתח עצמו. על הכלים שעוזר AI יכול להשתמש בהם: כלי ה-MCP של StreamLive Pro: רשימה מלאה ל-ChatGPT ול-Claude.

שאלות נפוצות

באיזה מסלול יש מפתחות API?

במסלול Studio. חיבור של ChatGPT או Claude דרך MCP כלול בכל מסלול ולא דורש מפתח.

איבדתי את מפתח ה-API. אפשר לראות אותו שוב?

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

ה-API מבקש אישור לפני שהוא מסיים שידור או מפרסם?

לא. דרך ה-API הבקשה ששלחתם היא ההחלטה. משתמשים ב-Idempotency-Key לניסיונות חוזרים בטוחים ובודקים על שידור שאפשר לבטל.

אפשר להגביל מה מפתח יכול לעשות?

כן. כשיוצרים מפתח מסמנים רק את ההרשאות שהוא צריך, ואפשר לקבוע שיפוג אחרי 30 יום, 90 יום או שנה.

אפשר לעלות לשידור דרך ה-API?

אפשר להכין ולתזמן שידורים, לשנות, לסיים ולבטל אותם. התמונה עצמה מגיעה מהסטודיו בדפדפן, מהטלפון או ממקודד כמו OBS.

המשך קריאה

תיעוד ה-REST API של StreamLive Pro: נקודות קצה ושדות

כל נקודות הקצה של ה-REST API של StreamLive Pro תחת ‎/api/v1, עם פרמטרים, שדות בקשה ושדות תשובה: שידורים, צ'אט, מפתחות שידור, שורטס, פוסטים ונתונים.

מה ChatGPT ו-Claude לא יכולים לעשות ב-StreamLive Pro

הגבולות של ChatGPT ו-Claude ב-StreamLive Pro, עם הסיבה לכל אחד ומה עושים במקום: חיבור רשתות, פוסטים לטיקטוק, העלאות, אישורים ועוד.

אילו הרשאות יש ל-ChatGPT ול-Claude בחשבון שלכם

כל הרשאה ש-ChatGPT או Claude יכולים לקבל בחשבון StreamLive Pro: מה כל אחת מאפשרת, אילו כלים צריכים אותה, מה אפשר להשאיר כבוי, ואיך משנים.

מה זה MCP (Model Context Protocol)? הסבר בלי ז'רגון

מה זה MCP, ה-Model Context Protocol, במילים ברורות: שרתים, כלים, OAuth והרשאות, ואיך ChatGPT ו-Claude משתמשים בו כדי לעבוד עם StreamLive Pro.

רוצים לנסות? 7 ימי ניסיון, בלי כרטיס אשראי.

להתחיל בחינם

האפליקציה לטלפון ראשי מרכז העזרה מדריכים פרטיות תנאי שימוש הצהרת נגישות