> העתק ציבורי של מדריך המפתחים של ViewStream (לקריאה גם על ידי סוכני AI). רשימת המדריכים: https://www.viewstream.co.il/he/developers/guide/index.md · תיעוד ה-API: https://api.viewstream.co.il/docs/

# ה-API של ViewStream — מדריך למפתחים

למפתחים שמחברים ל-ViewStream מערכת ניהול תוכן (CMS), מערכת חדשות, מערכת צד שרת (backend) או אפליקציה. כל מה ש-Studio עושה עובר
דרך ה-API הזה, כך שגם אינטגרציה יכולה לעשות את אותו הדבר: לרשום ולפרסם וידאו, להפעיל ערוצים ואת לוח השידורים שלהם, לחתוך
קליפים, להגן על הצפייה, לקרוא סטטיסטיקה ולקבל אירועים.

| מדריך | מה תמצאו בו |
|---|---|
| [getting-started.md](getting-started.md) | כתובת הבסיס, יצירת מפתח API ב-Studio, טבלת ההרשאות, הקריאה הראשונה |
| [conventions.md](conventions.md) | כללי JSON, שגיאות (problem+json), עימוד, הגבלות קצב, אידמפוטנטיות, משימות אסינכרוניות ותשאול, זרם האירועים, פורמטי זמן |
| [recipes.md](recipes.md) | מדריכים צעד אחר צעד עם `curl`: העלאת סרטון, רשימת צפייה חוזרת וחיפוש בה, כתובות צפייה וטוקנים חתומים, קליפים, סטטיסטיקה וייצוא נתונים גולמיים, ניטורים, Webhooks עם אימות חתימה, ניקוי מטמון וחימום מראש |
| [sites-delivery-api.md](sites-delivery-api.md) | ה-API הציבורי לקריאה שמאחורי ViewStream Sites (`/s/v1`), עבור ממשק קדמי (front end) משלכם |
| [player-integration.md](player-integration.md) | הטמעת הנגן (קישור שיתוף, iframe, תגית נגן), תצורות נגן, אירועי נגן, Beacons |
| [mcp.md](mcp.md) | שרת ה-MCP לעוזרי AI (Claude, ChatGPT, Cursor): מפתח API והרשאות, הכלים, חיבור לקוח, JSON-RPC גולמי, שגיאות |
| [nextjs.md](nextjs.md) | Next.js ו-Vercel: רכיבי הנגן של `@viewstream/next`, פונקציות שרת עם תגיות מטמון, נתיב webhook חתום, העלאות ישירות, Connect, אתר הבסיס |
| [lovable.md](lovable.md) | Lovable ואפליקציות דפדפן: Delivery API ציבורי + הנגן המתארח, בלי מפתח API; הגדרת Headless ב-Studio; הנחיה להדבקה |
| [versioning.md](versioning.md) | מה מנוהל בגרסאות, איך מתבצעים שינויים, איפה נמצא יומן השינויים |

## חומרי עזר

- **תיעוד API אינטראקטיבי:** `https://api.viewstream.co.il/docs/` (Swagger UI; מוגש על ידי
  internal/apidocs (באנגלית)). "Try it out" פונה לסביבת הייצור.
- **OpenAPI:** `https://api.viewstream.co.il/openapi.yaml` · `/openapi.json` · Sites Delivery:
  `/openapi/sites-delivery.yaml`.
- הערות נושאיות של צוות הפיתוח (באנגלית): webhooks,
  event export, playback tokens,
  player configurations, Sites,
  EPG, DVB EIT,
  catch-up exclusions,
  live-to-VOD, CHANGELOG.