מחברים את ViewStream לאתר, לאפליקציות ולמערכות שלכם.

iframe

ההטמעה הפשוטה ביותר, עובדת בכל מערכת ניהול תוכן. אפשרויות: autoplay=1 (מושתק), start=<seconds>, lang=he|en|ru|ar, config=<name>.

<iframe src="https://player.viewstream.co.il/e/acme/live/main"
        allow="autoplay; fullscreen; picture-in-picture" allowfullscreen
        style="aspect-ratio:16/9;width:100%;border:0"></iframe>

<!-- a video or a clip -->
<iframe src="https://player.viewstream.co.il/e/acme/vod/<asset-id>" …></iframe>
<iframe src="https://player.viewstream.co.il/e/acme/clip/<clip-id>" …></iframe>

תגית נגן

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

<script async src="https://player.viewstream.co.il/embed.js"
        data-src="https://cdn.example.net/live/acme/main/master.m3u8"
        data-tenant="acme"
        data-config="news"
        data-lang="he"></script>

<script>
document.addEventListener('vs:ready', function (e) {
  var player = e.detail.player;   // a Video.js player
  player.on('play',  function () { /* … */ });
  player.on('ended', function () { /* … */ });
});
</script>

קאץ'-אפ: רשימה וחיפוש

הרשאה channels:read. נגנו מ-play_start עד play_end: ההתחלה והסיום האמיתיים של השידור, כפי שה-AI זיהה, ולא זמני הלוח.

# your channels and their ids
curl -s "$API/channels" "${H[@]}"

# programmes of one day
curl -s "$API/channels/<channel-id>/catchup?from=2026-10-05T00:00:00Z&to=2026-10-06T00:00:00Z" "${H[@]}"

# search titles, guide text and AI summaries
curl -s -G "$API/channels/<channel-id>/catchup/search" \
     --data-urlencode "q=ריבית" "${H[@]}"

סיכום AI ומגישים

הרשאה assets:read. סיכום בעברית, מגישים מאומתים ונושאים לכל שידור.

curl -s "$API/programmes/<programme-id>/summary" "${H[@]}"

{
  "status": "ready",
  "summary": "…",
  "presenters": ["…"],
  "presenters_source": "series",
  "topics": ["…", "…"],
  "words": 104,
  "updated_at": "2026-10-06T18:12:40Z"
}

כתוביות

הרשאה assets:read. כל שפות הכתוביות של שידור, סרטון או קליפ, ולכל אחת קובץ WebVTT מוכן לשימוש — או הכתוביות המתוזמנות כ-JSON.

# languages, status and the WebVTT URL of each track
curl -s "$API/subtitles/subjects/<programme-id>" "${H[@]}" \
  | jq '.languages[] | {lang, status, vtt: .track.vtt_url}'

# the cues of one track as JSON
curl -s "$API/subtitles/tracks/<track-id>/cues" "${H[@]}"

אותו דבר ב-JavaScript

מהשרת שלכם (Node 18 ומעלה, בלי ספריות).

const API = 'https://api.viewstream.co.il/v1';
const vs = (path) => fetch(API + path, {
  headers: { Authorization: `Bearer ${process.env.VS_KEY}` },
}).then((r) => r.ok ? r.json() : Promise.reject(r.status));

const { items } = await vs(`/channels/${channelId}/catchup`);
for (const p of items.filter((p) => p.status === 'recorded')) {
  const s = await vs(`/programmes/${p.id}/summary`);
  console.log(p.title, s.presenters.join(', '), s.summary);
}

דף סרטון

מפתח ה-API נשאר בשרת. הדפים נשמרים במטמון ומתרעננים לפי תגית.

// app/v/[id]/page.tsx
import { createViewStream } from '@viewstream/next/server';
import { ViewStreamPlayer } from '@viewstream/next/client';

const vs = createViewStream(); // VIEWSTREAM_API_KEY, VIEWSTREAM_TENANT

export default async function Page({ params }) {
  const { id } = await params;
  const video = await vs.assets.get(id);
  return <ViewStreamPlayer tenant="acme" kind="vod" id={video.id} lang="he" />;
}

מפרסמים ב-Studio, האתר מתעדכן

הפנו webhook לנתיב הזה עם asset.published,‏ clip.final ו-artifact.published. החתימה נבדקת, והדפים שהשתנו מתרעננים מיד.

// app/api/viewstream/webhook/route.ts
import { viewstreamWebhook } from '@viewstream/next/webhook';

export const POST = viewstreamWebhook({
  secret: process.env.VIEWSTREAM_WEBHOOK_SECRET,
});