Интеграции

Как PrimeConnect работает в связке с PrimeCast и PrimeMeet: схемы интеграции, REST API и вебхуки.

PrimeConnect редко работает в одиночку: типовая схема экосистемы Prime — приём и обработка видео в PrimeConnect, массовая раздача через PrimeCast, а интерактивные форматы — через PrimeMeet.

Связка с PrimeCast

PrimeCast принимает готовый канал PrimeConnect и транслирует его на площадки доставки с кешированием — это снимает нагрузку с сервера PrimeConnect при большой аудитории.

В консоли PrimeCast создайте приёмный канал типа «Внешний источник».
Укажите HLS-URL канала PrimeConnect из раздела Каналы.
Включите синхронизацию расписания — PrimeCast подтянет эфиры автоматически.

Статусы эфира синхронизируются в обе стороны: «В эфире» в PrimeConnect означает доступность потока для зрителей PrimeCast.

Связка с PrimeMeet

Из встречи PrimeMeet можно одной кнопкой вывести видео в канал PrimeConnect — так внутренняя видеоконференция превращается в публичную трансляцию. Настройка выполняется на стороне PrimeMeet: укажите адрес API PrimeConnect и токен сервисной учётной записи.

REST API

API доступен по адресу https://connect.prime.ru/api/v2 с аутентификацией по токену. Пример — создание трансляции:

{
  "channelId": "ch_1024",
  "title": "Еженедельная планёрка",
  "type": "live",
  "recording": true,
  "chat": { "enabled": true, "slowModeSec": 5 }
}

Ответ содержит идентификатор трансляции и ссылку предпросмотра.

Пример запроса на TypeScript:

const response = await fetch('https://connect.prime.ru/api/v2/broadcasts', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + token,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channelId: 'ch_1024',
    title: 'Еженедельная планёрка',
    type: 'live',
    recording: true,
  }),
});
const broadcast = await response.json();

Вебхуки

PrimeConnect уведомляет внешние системы о событиях эфира. Подписка настраивается в Настройки → Вебхуки.

Событие	Когда отправляется
broadcast.started	Поток появился на точке приёма
broadcast.ended	Трансляция завершена
recording.ready	Запись обработана и доступна
stream.unstable	Битрейт ниже порога 30 секунд

Примечание. Приёмник вебхуков должен отвечать кодом 200 в течение 5 секунд, иначе событие будет отправлено повторно до трёх раз.

Сквозная аутентификация

Во всех продуктах Prime действует единый вход через корпоративный каталог: пользователь, вошедший в PrimeConnect, не вводит пароль повторно в PrimeCast и PrimeMeet. Токены сервисных учётных записей заводятся отдельно и не дают доступа к пользовательским данным.