Boomstream API Ecosystem: REST API, API Explorer и MCP Server для управления видеоконтентом

В современном цифровом мире видеоконтент стал основой коммуникации, образования и маркетинга. Платформа Boomstream предлагает комплексное решение для видеохостинга, конференций, прямых трансляций и монетизации контента. В этой статье мы подробно рассмотрим API-экосистему Boomstream, включая REST API, API Explorer и инновационный MCP Server, который открывает новые возможности для интеграции с искусственным интеллектом.

Что такое Boomstream?

Boomstream — это онлайн-видеоплатформа, которая позволяет загружать, хранить и транслировать видеоконтент, а также монетизировать его через продажу доступа к видео и прямым эфирам. Платформа поддерживает загрузку видео любым способом: через браузер, FTP, TUS, Google Drive, Vimeo и API. Среди ключевых возможностей:

• Брендированный видеоплеер
• Комплексная защита контента
• Прием оплаты в плеере Pay-Per-View (PPV)
• Статистика просмотров
• Интеграция с платежными системами

Для разработчиков Boomstream предоставляет API, позволяющий полностью автоматизировать управление видеоконтентом, трансляциями, плейлистами, чатами и другими аспектами платформы.

Boomstream REST API: полный контроль над видеоплатформой

Boomstream REST API v1.2 — это основной интерфейс для программного взаимодействия с платформой. API позволяет управлять видеохостингом, прямыми трансляциями, PPV-контентом, конференциями, папками, плейлистами, статистикой, чатами, субтитрами, таймкодами, вебхуками и многим другим.

REST API доступен по адресу https://boomstream.ru/documentation/api

Ключевые особенности REST API

• Авторизация выполняется по ключу apikey (находится в разделе «Интеграция» в настройках личного кабинета). Ключ можно передать двумя способами:
  • параметром apikey — в GET-параметрах или в JSON-теле запроса;
  • HTTP-заголовком Authorization: Bearer <apikey>. Если параметр apikey не передан, ключ берётся из этого заголовка. Явно переданный параметр apikey имеет приоритет над заголовком.
• Форматы передачи данных:
  • Параметры можно передавать как через GET, так и через POST;
  • Альтернативно — POST с заголовком Content-Type: application/json и всеми параметрами (включая apikey) в JSON-теле;
  • Форматы ответа: JSON и XML (параметр format=json или format=xml).
• Версионирование: передайте ver=1.2, чтобы использовать актуальную версию API с обновлёнными форматами ответов.
• Статус ответов: каждый ответ содержит параметр Status: Success или Failed. При ошибке добавляется поле Message с описанием.

Основные разделы API

REST API охватывает все ключевые функции платформы:

API Explorer: интерактивная документация для быстрого старта

API Explorer Boomstream — это интерактивный инструмент, который позволяет разработчикам изучать и тестировать API-методы прямо в браузере, без необходимости писать код.

Преимущества API Explorer

1. Быстрое знакомство с API — вы можете сразу увидеть, как работают различные методы, какие параметры они принимают и какие данные возвращают.
2. Тестирование без кода — отправляйте реальные запросы к API и мгновенно получайте ответы, что значительно ускоряет процесс разработки и отладки.
3. Наглядная документация — все методы структурированы по разделам, что упрощает навигацию и поиск нужных функций.
4. Снижение порога входа — даже разработчики, не знакомые с платформой, могут быстро освоиться и начать интеграцию.

API Explorer доступен по адресу https://api.boomstream.ru/ и служит отправной точкой для интеграции с Boomstream.

MCP Server: Boomstream для эпохи искусственного интеллекта

Boomstream MCP Server — это инновационное решение, реализующее протокол Model Context Protocol (MCP) для интеграции Boomstream API с LLM-агентами. MCP — это открытый протокол, разработанный для стандартизации взаимодействия между AI-приложениями и внешними инструментами и источниками данных.

Что такое MCP Server?

MCP Server — это сервер, который предоставляет AI-агентам (таким как Claude Desktop, claude.ai, VS Code MCP extension и другие совместимые клиенты) доступ к инструментам и данным через стандартизированный протокол. Boomstream MCP Server превращает все функции Boomstream API в набор инструментов, которые AI-агенты могут вызывать естественным образом.

Технические характеристики

• Версия: v0.7.1
• Количество инструментов: 105 инструментов, охватывающих 28 семейств ресурсов
• Транспорты:
  • stdio — для Claude Desktop (локальный дочерний процесс)
  • SSE (Server-Sent Events) — для claude.ai и удаленных клиентов, хостится на mcp.boomstream.com
• Аутентификация: Authorization: Bearer (HTTP header)

Эндпоинты

Лимиты

• Per-IP: 120 запросов/мин, 20 одновременных соединений
• Per-session: 120 запросов/мин (устойчивый), 40 burst → HTTP 429 + Retry-After

Жизненный цикл сессии

• Сессии хранятся в памяти на каждом pod'е
• Меж-pod маршрутизация через forwarding
• Тайм-аут бездействия: 30 минут
• SSE-поток автоматически закрывается после тайм-аута

Архитектура

• Фаза A: общий apikey через Bearer
• Фаза B (планируется): per-user OAuth

Быстрый старт с MCP Server

Через Claude Code CLI:

claude mcp add --transport sse boomstream https://mcp.boomstream.com/sse \
  --header "Authorization: Bearer <your-api-key>"
claude mcp list  # ожидайте: boomstream ✓ Connected

Через Claude Desktop
Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "boomstream": {
      "transport": "sse",
      "url": "https://mcp.boomstream.com/sse",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Через MCP SDK (Node.js):

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'

const transport = new SSEClientTransport(
  new URL('https://mcp.boomstream.com/sse'),
  { requestInit: { headers: { Authorization: `Bearer ${apikey}` } } }
)
const client = new Client({ name: 'my-app', version: '0.1' }, { capabilities: {} })
await client.connect(transport)

NPM пакет: @boomstream/mcp

Каталог инструментов MCP Server

MCP Server предоставляет 105 инструментов, сгруппированных по разделам:

Примеры инструментов:

• boomstream_media_info
• boomstream_ppv_list_buyers
• boomstream_live_create

LLM-агенты вызывают эти инструменты, а MCP Server транслирует их в HTTP-запросы к https://boomstream.com/api/, парсит ответы и возвращает структурированный JSON.

Преимущества MCP Server для бизнеса

1. Интеграция с AI без написания кода — AI-агенты могут управлять видеоконтентом через естественный язык.
2. Снижение сложности и затрат — не нужно разрабатывать собственные интеграции с AI.
3. Масштабируемость и гибкость — MCP Server обеспечивает стандартизированное взаимодействие.
4. Доступ к реальным данным в реальном времени — AI-агенты могут запрашивать API напрямую.
5. Единая точка управления — все 105 инструментов доступны через один MCP Server.

Сценарии использования

Для разработчиков

• Интеграция Boomstream с существующими системами через REST API
• Автоматизация загрузки и управления видео
• Создание кастомных решений для работы с контентом
• Разработка AI-агентов для управления видеоплатформой через MCP Server

Для бизнеса

• Создание образовательных платформ с видеоконтентом
• Организация онлайн-конференций и вебинаров
• Монетизация видео через PPV и подписки
• Аналитика просмотров и поведения зрителей

Заключение

Экосистема Boomstream предлагает разработчикам и бизнесу полный набор инструментов для работы с видеоконтентом:

• REST API — интерфейс для программного управления всеми аспектами платформы
• API Explorer — интерактивная документация для быстрого освоения и тестирования API
• MCP Server — решение, открывающее возможности интеграции с AI-агентами и LLM

Начните работу сегодня

• Изучите REST API: https://boomstream.ru/documentation/api
• Попробуйте API Explorer: https://api.boomstream.ru/
• Подключите MCP Server: https://mcp.boomstream.com/
• Установите NPM пакет: npm install -g @boomstream/mcp