StreamLive Pro למפתחים

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

שרת MCP

ל-Claude, ל-ChatGPT ולכל לקוח MCP. התחברות ב-OAuth עם מסך אישור.

https://streamlivepro.io/mcp

הוראות חיבור

REST API v1

JSON מעל HTTPS, מפתח API או OAuth. מפרט OpenAPI 3.1.

https://streamlivepro.io/api/v1

openapi.json

MCP

הכלים שעוזר יכול להפעיל. כלי קריאה לא משנים כלום. כלים שמסיימים, מבטלים או מפרסמים דורשים אישור מפורש שלכם בשיחה.

כלי	מה הוא עושה	סוג	הרשאה
`get_account`	פרטי החשבון: חבילה, ניסיון, מגבלות ושימוש החודש.	קריאה	`read:account`
`list_connections`	הערוצים המחוברים ומצבם, ומה עוד לא מחובר (החיבור עצמו נעשה באפליקציה).	קריאה	`read:streams`
`get_go_live_readiness`	הכול כדי לעלות לשידור: מה מוכן, מה חסר, ובאיזה סדר.	קריאה	`read:account` `read:streams`
`list_lives`	השידורים: באוויר, מתוזמנים, מוכנים ושהסתיימו.	קריאה	`read:streams`
`get_live`	שידור אחד: יעדים, צופים, האם וידאו מגיע עכשיו ובעיות ביעדים.	קריאה	`read:streams`
`get_live_chat`	הצ’אט של שידור מכל הרשתות.	קריאה	`read:comments`
`get_stream_key`	כתובת RTMP ומפתח שידור ל-OBS או vMix, מוסתר כברירת מחדל. הרשאה נפרדת.	קריאה	`read:stream_keys`
`prepare_live`	יצירת שידור לעלייה מיידית.	כתיבה	`write:streams`
`schedule_live`	תזמון שידור עם תזכורת.	כתיבה	`write:streams`
`update_live`	עריכת כותרת, תיאור, מועד, ערוצים ופרטיות.	כתיבה	`write:streams`
`cancel_scheduled_live`	ביטול שידור שעוד לא שודר, אחרי אישור.	דורש אישור	`write:streams`
`end_live`	סיום שידור בכל הערוצים, אחרי אישור.	דורש אישור	`write:streams`
`list_clips`	השורטס שנחתכו מההקלטות, עם קבצים מוכנים.	קריאה	`read:clips`
`create_clips`	חיתוך שורטס מהקלטה של שידור שהסתיים, עם כתוביות ותרגום.	כתיבה	`write:clips`
`publish_clip`	פרסום או תזמון שורט בערוצים, רק אחרי תצוגה מקדימה ואישור.	דורש אישור	`publish`
`list_posts`	פוסטים אחרונים ומתוזמנים.	קריאה	`read:clips`
`get_post`	התוצאה של פוסט בכל רשת.	קריאה	`read:clips`
`update_scheduled_post`	שינוי מועד או טקסט של פוסט מתוזמן.	כתיבה	`publish`
`cancel_scheduled_post`	ביטול פוסט מתוזמן, אחרי אישור.	דורש אישור	`publish`
`get_analytics_summary`	סיכום ביצועים מול התקופה הקודמת, לפי רשת, עם תובנות.	קריאה	`read:analytics`
`get_podcast_feed_status`	קישור הפיד של הפודקאסט ואיפה הוא עומד ב-Spotify, ב-Apple Podcasts ובאפליקציות אחרות.	קריאה	`read:streams`
`search_help`	חיפוש במרכז העזרה.	קריאה	`read:account`
`list_network_cameras`	The network cameras and NDI sources that the person’s StreamLive Pro Studio desktop app finds on their local network: name, maker, type (PTZ camera, NDI source, IP camera), whether it has PTZ, its saved presets, whether it can be used in the browser studio, and whether it is on air in the desktop studio. Needs the desktop app open and signed in.	קריאה	`read:streams`
`control_camera`	Moves one PTZ camera from list_network_cameras through the person’s desktop app: move (pan / tilt / zoom speeds from -1 to 1 for a short time, then it stops by itself), stop, go_to_preset, save_preset (needs confirm: true), home, auto_focus. A camera on air in the desktop studio does not move. Ask before moving a camera during a live.	כתיבה	`control:cameras`

REST API

כתובת הבסיס: https://streamlivepro.io/api/v1

הקריאה הראשונה

curl https://streamlivepro.io/api/v1/readiness \
  -H "Authorization: Bearer $SLP_API_KEY"

תזמון שידור

curl -X POST https://streamlivepro.io/api/v1/lives \
  -H "Authorization: Bearer $SLP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2b7e-weekly-show" \
  -d '{"title":"Weekly show","scheduled_at":"2026-11-03T19:30:00+02:00","destination_ids":["dest_..."]}'

נתיב	מה
`GET /me`	פרטי החשבון: חבילה, ניסיון, מגבלות ושימוש החודש.
`GET /connections`	הערוצים המחוברים ומצבם, ומה עוד לא מחובר (החיבור עצמו נעשה באפליקציה).
`GET /readiness`	הכול כדי לעלות לשידור: מה מוכן, מה חסר, ובאיזה סדר.
`GET /lives`	השידורים: באוויר, מתוזמנים, מוכנים ושהסתיימו.
`POST /lives`	יצירת שידור (עכשיו, או מתוזמן עם scheduled_at)
`GET /lives/{id}`	שידור אחד: יעדים, צופים, האם וידאו מגיע עכשיו ובעיות ביעדים.
`PATCH /lives/{id}`	עריכת כותרת, תיאור, מועד, ערוצים ופרטיות.
`DELETE /lives/{id}`	ביטול שידור שעוד לא שודר, אחרי אישור.
`POST /lives/{id}/end`	סיום שידור בכל הערוצים, אחרי אישור.
`GET /lives/{id}/chat`	הצ’אט של שידור מכל הרשתות.
`GET /lives/{id}/ingest`	כתובת RTMP ומפתח שידור ל-OBS או vMix, מוסתר כברירת מחדל. הרשאה נפרדת.
`GET /clips`	השורטס שנחתכו מההקלטות, עם קבצים מוכנים.
`POST /clips`	חיתוך שורטס מהקלטה של שידור שהסתיים, עם כתוביות ותרגום.
`GET /posts`	פוסטים אחרונים ומתוזמנים.
`POST /posts`	פרסום או תזמון שורט בערוצים, רק אחרי תצוגה מקדימה ואישור.
`GET /posts/{id}`	התוצאה של פוסט בכל רשת.
`PATCH /posts/{id}`	שינוי מועד או טקסט של פוסט מתוזמן.
`DELETE /posts/{id}`	ביטול פוסט מתוזמן, אחרי אישור.
`GET /analytics/summary`	סיכום ביצועים מול התקופה הקודמת, לפי רשת, עם תובנות.
`GET /podcasts/feeds`	קישור הפיד של הפודקאסט ואיפה הוא עומד ב-Spotify, ב-Apple Podcasts ובאפליקציות אחרות.
`GET /help/search`	חיפוש במרכז העזרה.

רשימות מחזירות next_cursor; שלחו אותו כ-cursor לעמוד הבא. כתיבה מקבלת Idempotency-Key: אותו מפתח בתוך 24 שעות מחזיר את התשובה הראשונה במקום לבצע שוב.

הזדהות

מפתח API לקוד שלכם: יוצרים בהגדרות > אפליקציות מחוברות ו-API. המפתח מוצג פעם אחת ונשמר אצלנו רק כגיבוב. זמין במסלולים Studio ו-Business.

OAuth 2.1 לאפליקציות שפועלות בשם אנשים אחרים: Authorization Code עם PKCE (S256), Client ID Metadata Documents או רישום דינמי, טוקנים קצרים וטוקן רענון מתחלף.

https://streamlivepro.io/.well-known/oauth-authorization-server

Scopes

Scope	מאפשר
`read:account`	לראות את שם החשבון, החבילה והשימוש החודשי
`read:streams`	לראות את השידורים, הערוצים המחוברים ומצב החיבורים
`write:streams`	לתזמן, לערוך, לבטל ולסיים שידורים
`read:clips`	לראות את השורטס שנחתכו מההקלטות
`write:clips`	לחתוך שורטס חדשים מהקלטה שלכם
`publish`	לפרסם ולתזמן פוסטים בערוצים המחוברים, רק אחרי אישור שלכם בשיחה
`read:analytics`	לראות סיכומי ביצועים
`read:comments`	לקרוא את הצ’אט של השידורים שלכם
`read:stream_keys`	לראות את מפתח השידור (RTMP). מי שמחזיק במפתח יכול לשדר בשמכם רגיש
`write:library`	להעלות סרטונים לספרייה אפליקציות StreamLive Pro בלבד
`pair:camera`	לחבר טלפון כמצלמה לשידור אפליקציות StreamLive Pro בלבד
`control:cameras`	לראות ולהזיז את מצלמות הרשת שהסטודיו במחשב שלכם מוצא (PTZ)

מגבלות קצב

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

כל תשובה כוללת RateLimit-Limit, RateLimit-Remaining ו-RateLimit-Reset. אחרי 429 מגיע Retry-After. מגבלות החבילה (ערוצים בבת אחת, שעות שידור, שורטס) חלות בנוסף, כמו באתר.

שגיאות

{ "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" } }

HTTP	type	דוגמאות ל-code
400	`invalid_request_error`	`invalid_arguments` `destinations_required` `unknown_destination` `title_required` `time_in_past` `publish_in_app`
401	`authentication_error`	`missing_credentials` `invalid_api_key` `invalid_token`
403	`permission_error`	`insufficient_scope` `plan_limit` `account_blocked` `not_available`
404	`not_found_error`	`not_found` `unknown_endpoint`
409	`conflict_error`	`already_live` `not_live` `live_ended` `no_recording` `already_published`
422	`invalid_request_error`	`idempotency_key_reused`
429	`rate_limit_error`	`rate_limited`
5xx	`api_error`	`upstream_error` `internal_error` `temporarily_unavailable`

בטיחות ופרטיות

חיבור רשתות, תשלום וסיסמאות קורים רק בתוך StreamLive Pro. אף כלי לא מבקש אותם.
מפתח שידור דורש הרשאה נפרדת, ומוצג מוסתר כברירת מחדל.
פרסום מחייב תצוגה מקדימה ואישור; סיום וביטול מחייבים אישור מפורש.
טקסט שכתבו אנשים או רשתות מסומן בתשובות כתוכן משתמש, כדי שעוזר לא יתייחס אליו כהוראה.
כל קריאה נרשמת אצלנו (מי, מה, מתי - בלי התוכן). אפשר לנתק אפליקציה בכל רגע בהגדרות.

בדרך

העלאה לספרייה שאפשר להמשיך אחרי ניתוק, וחיבור טלפון כמצלמה לפי חשבון. מופיעים ב-OpenAPI עם x-status: planned ומחזירים 501 היום.

גרסאות ותמיכה

v1 יציב: מוסיפים שדות ונתיבים בלי לשבור. שינוי שובר יגיע ב-v2 עם הודעה מראש. שאלות: [email protected]