StreamLive Proתיעוד ה-REST API של StreamLive Pro: נקודות קצה ושדות
כל נקודות הקצה של ה-REST API של StreamLive Pro תחת /api/v1, עם פרמטרים, שדות בקשה ושדות תשובה: שידורים, צ'אט, מפתחות שידור, שורטס, פוסטים ונתונים.
ה-REST API של StreamLive Pro מריץ את אותן פעולות כמו הכלים של ChatGPT ו-Claude, אבל בשביל הקוד שלכם. הכתובת הבסיסית היא https://streamlivepro.io/api/v1. קוראים לה עם מפתח API (במסלול Studio) כ-Bearer token. בעמוד הזה מופיעה כל נקודת קצה עם הפרמטרים שלה והשדות שהיא מחזירה. יצירה ושמירה של מפתח: מפתחות API למפתחים. קודי שגיאה: שגיאות API.
התיאור המלא, בפורמט שמכונה קוראת, נמצא ב-https://streamlivepro.io/api/v1/openapi.json. הוא מסמן את ה-API כבטא סגורה, ולכן כדאי לעבור עליו לפני שבונים.
היסודות
- אימות. כותרת Authorization: Bearer ואחריה המפתח (מתחיל ב-slp_). מפתחות שנוצרו לפני שיטת המפתחות הנוכחית (מתחילים ב-sl_) עדיין עובדים, עם ההרשאות שהיו להם.
- גוף הבקשה. ב-POST וב-PATCH שולחים אובייקט JSON עם Content-Type: application/json. שדות לא מוכרים נדחים.
- מזהים. לכל מזהה יש קידומת: live_ לשידורים, clip_ לשורטס, post_ לפוסטים, dest_ ליעדים. מזהי יעדים מקבלים מ-GET /connections.
- זמנים. ISO 8601 עם אזור זמן, למשל 2026-11-03T19:30:00+02:00. מועד לתזמון צריך להיות לפחות דקה קדימה ולכל היותר שנה קדימה.
- תשובות. 200, או 201 ל-POST שיוצר משהו. בכל תשובה יש כותרת Request-Id וכותרות של מגבלת קצב.
- הרשאות. כל נקודת קצה צריכה הרשאה על המפתח, כמו שמופיע בטבלאות. מפתח בלי ההרשאה מקבל 403 insufficient_scope.
קריאה ראשונה:
curl https://streamlivepro.io/api/v1/me -H "Authorization: Bearer slp_..."
חשבון וערוצים
| שיטה ונתיב | הרשאה | מה מקבלים |
|---|---|---|
| GET /me | read:account | name, email, plan, on_trial, trial_days_left, can_start_live, streaming_software_allowed, limits (channels_at_once, live_hours_per_month, clips_per_period, storage_gb: מספר, או מילה במקום מספר כשהמסלול לא קובע תקרה), usage |
| GET /connections | read:streams | connections עם network, account, status (ready או needs_attention), problem, can_go_live, live_needs_key, can_publish_here, destinations (id, name, kind); not_connected_main_networks; connect_url |
| GET /readiness | read:account, read:streams | ready_to_go_live, next_steps לפי הסדר, ways_to_go_live |
בחיבור אחד יכולים להיות כמה יעדים, למשל חשבון פייסבוק עם כמה עמודים. בקריאות שלמטה משתמשים במזהה היעד, לא בשם הרשת.
שידורים
| שיטה ונתיב | הרשאה | פרמטרים או גוף |
|---|---|---|
| GET /lives | read:streams | status (live, scheduled, ready, ended), limit 1-50 (ברירת מחדל 20), cursor מתוך next_cursor |
| POST /lives | write:streams | title (1-200, חובה), destination_ids (1-30, חובה), description (עד 5,000), source (camera או encoder), youtube_privacy (public, unlisted, private), scheduled_at |
| GET /lives/{id} | read:streams | אין |
| PATCH /lives/{id} | write:streams | כל אחד מ-title, description, scheduled_at, destination_ids, youtube_privacy |
| DELETE /lives/{id} | write:streams | אין. מבטל שידור שעוד לא שודר |
| POST /lives/{id}/end | write:streams | אין. מסיים שידור שבאוויר בכל הערוצים |
| GET /lives/{id}/chat | read:comments | limit 1-100 (ברירת מחדל 50) |
| GET /lives/{id}/ingest | read:stream_keys | reveal=true כדי לראות את המפתח המלא |
POST /lives בלי scheduled_at מכין שידור שמתחיל עכשיו. עם scheduled_at הוא מתזמן אותו. שום דבר לא עולה לאוויר עד שמגיע וידאו מהסטודיו בדפדפן, מהטלפון או ממקודד.
שידור בתשובה כולל: id, title, description, status (live, scheduled, ready, ended), scheduled_at, started_at, ended_at, duration_seconds, privacy, destinations (id, network, network_name, name), peak_viewers, total_views, recording_available ו-links. GET /lives/{id} מוסיף video_arriving ו-destination_problems לפני השידור ובמהלכו. PATCH מוסיף updated, רשימת השדות שהשתנו.
הכללים שהשרת אוכף: שידור שהסתיים לא משתנה. באמצע שידור אי אפשר לשנות שעה וערוצים, ושינוי כותרת ותיאור נשלח גם לרשתות. שידור שכבר שודר לא נמחק. הודעות צ'אט כוללות network_name, author, text, from_moderator, from_you ו-at. תשובת ה-ingest כוללת rtmp_server, srt_url, stream_key (מוסתר, עם ארבעת התווים האחרונים, אלא אם reveal=true) ו-revealed. בניסיון היא נדחית, כי תוכנת שידור לא כלולה בו.
curl -X POST https://streamlivepro.io/api/v1/lives \
-H "Authorization: Bearer slp_..." -H "Content-Type: application/json" \
-H "Idempotency-Key: weekly-qa-2026-11-10" \
-d '{"title":"Weekly Q&A","destination_ids":["dest_..."],"scheduled_at":"2026-11-10T20:00:00+02:00","source":"camera"}'
שורטס
| שיטה ונתיב | הרשאה | פרמטרים או גוף |
|---|---|---|
| GET /clips | read:clips | live_id (רשות), limit 1-50 (ברירת מחדל 20) |
| POST /clips | write:clips | live_id (חובה), translate_to: עד 3 קודי שפה |
POST /clips מתחיל לחתוך שורטס משידור שהסתיים ויש לו הקלטה, עם כתוביות בשפת הדיבור. זה נספר במכסת השורטס של החשבון. translate_to מקבל he, en, ar, ru, es, fr, de, pt, it, yi, am, uk, tr, hi, zh, ja, ko, nl ו-pl. התשובה אומרת started, והשורטס מופיעים ב-GET /clips כשהם מוכנים. לכל שורט יש id, live_id, title, duration_seconds, score, status, created_at ו-files (aspect, caption_language, duration_seconds, download_url).
פוסטים
| שיטה ונתיב | הרשאה | פרמטרים או גוף |
|---|---|---|
| GET /posts | read:clips | status (scheduled, pending, processing, completed, failed, cancelled, partial), limit 1-50 |
| POST /posts | publish | clip_id, destination_ids ו-title (1-100) חובה; description (עד 2,000), publish_at, youtube_privacy, aspect (למשל 9:16), caption_language |
| GET /posts/{id} | read:clips | אין. מוסיף תוצאות לכל רשת |
| PATCH /posts/{id} | publish | כל אחד מ-publish_at, title, description, לפוסט שעדיין מתוזמן |
| DELETE /posts/{id} | publish | אין. מבטל פוסט מתוזמן |
POST /posts מפרסם מיד, או ב-publish_at. דרך ה-API אין שלב של תצוגה מקדימה: הבקשה ששלחתם היא ההחלטה. youtube_privacy חובה כשיש יעד YouTube. יעדי טיקטוק, פינטרסט ווואטסאפ נדחים עם publish_in_app, ואת הפוסטים האלה עושים במסך הפרסום. התוצאות לכל רשת כוללות network_name, destination, status, post_url ו-problem.
נתונים, פודקאסט ועזרה
| שיטה ונתיב | הרשאה | פרמטרים |
|---|---|---|
| GET /analytics/summary | read:analytics | days: 7, 28, 90 או 365 (ברירת מחדל 28); network, למשל youtube |
| GET /podcasts/feeds | read:streams | אין |
| GET /help/search | read:account | q, בין 2 ל-120 תווים |
תשובת הנתונים כוללת period_days, data_as_of, totals (views, watch_time_minutes, engagement, posts, כל אחד עם current, previous ו-change_pct; followers; live_hours), networks, top_posts (עד 5), insights (עד 5) ו-networks_without_numbers. תשובת הפודקאסט מציגה כל תוכנית עם feed_url, episodes_in_feed, latest_episode, דגלי מוכנות ומצב לכל אפליקציה (needs_setup, feed_ready, waiting_for_claim, waiting_for_verification, connected).
נקודות קצה מתוכננות
POST /uploads, PUT /uploads/{id}/parts/{n}, POST /uploads/{id}/complete ו-POST /camera-pairings מופיעים כמתוכננים ועונים היום 501 not_implemented. כל נתיב אחר עונה 404 unknown_endpoint.
עמודים קשורים
אותן פעולות ככלים של עוזרים: רשימת הכלים. ממה תשובת מפתח השידור מגינה: מפתח שידור דרך העוזר. מה הכלים משאירים לאפליקציה: מה העוזרים לא יכולים לעשות.
מגבלות
מגבלות קצב וניסיונות חוזרים בטוחים עם Idempotency-Key מוסברים במפתחות API למפתחים. המגבלות של המסלול חלות על כל קריאה, בדיוק כמו באתר.
שאלות נפוצות
מה הכתובת הבסיסית של ה-API של StreamLive Pro?
https://streamlivepro.io/api/v1, עם מפתח API שנשלח כ-Bearer token.
איך מתזמנים שידור דרך ה-API?
שולחים POST /lives עם כותרת, מזהי יעדים מ-GET /connections ו-scheduled_at. בלי scheduled_at השידור מוכן להתחיל עכשיו.
ה-API מבקש אישור לפני פרסום?
לא. POST /posts מפרסם ברגע שהבקשה מתקבלת. בודקים עם פוסט מתוזמן שאפשר לבטל.
אפשר להעלות סרטון דרך ה-API?
עוד לא. נקודות הקצה של ההעלאה מתוכננות ועונות 501.
למה הבקשה שלי נדחית עם publish_in_app?
פוסטים לטיקטוק, לפינטרסט ולוואטסאפ נעשים במסך הפרסום של StreamLive Pro, לא דרך ה-API.
המשך קריאה
כל הרשאה ש-ChatGPT או Claude יכולים לקבל בחשבון StreamLive Pro: מה כל אחת מאפשרת, אילו כלים צריכים אותה, מה אפשר להשאיר כבוי, ואיך משנים.
מה זה MCP (Model Context Protocol)? הסבר בלי ז'רגוןמה זה MCP, ה-Model Context Protocol, במילים ברורות: שרתים, כלים, OAuth והרשאות, ואיך ChatGPT ו-Claude משתמשים בו כדי לעבוד עם StreamLive Pro.
כלי ה-MCP של StreamLive Pro: רשימה מלאה ל-ChatGPT ול-Claudeכל 24 כלי ה-MCP של StreamLive Pro ש-ChatGPT ו-Claude יכולים להשתמש בהם: מה כל כלי עושה, אילו רק קוראים, אילו משנים ואילו מחכים לאישור שלכם.
Webhooks למפתחים: אירועים, חתימה ושליחהWebhooks של StreamLive Pro למפתחים: מוסיפים כתובת https בהגדרות, מקבלים את stream.started ואירועים נוספים, ובודקים את חתימת HMAC-SHA256 ב-Node או ב-Python.
רוצים לנסות? 7 ימי ניסיון, בלי כרטיס אשראי.
להתחיל בחינם