Перейти к основному содержимому

Мини-плеер и быстрая проверка стрима

Интеграция мини-плеера и live-виджета

Мини-плеер по товару — GET /v2/mini-player/stream

Мини-плеер

GET https://app.shopstory.live/v2/mini-player/stream?application=<appId>&productCode=<sku>

Параметры:

ПараметрОбязательноОписание
applicationИдентификатор приложения
productCode⛔️SKU/артикул товара
feedProductId⛔️ID товара из фида (используйте либо productCode, либо feedProductId)

Ответ содержит deep link, название стрима и статусы. Используйте deep link для открытия веб‑плеера или нативного экрана.

Любой live — GET /v2/mini-player/online

Получить любую актуальную live-трансляцию для виджета «Сейчас в эфире»:

GET https://app.shopstory.live/v2/mini-player/online?application=<appId>

Ответ: deep link, название трансляции, изображение превью. Если live-стримов нет, body.translation будет null.

Быстрый статус — GET /v3/translation/quick-state

Используйте для дешёвого поллинга UI:

GET https://app.shopstory.live/v3/translation/quick-state?translationId=<streamId>

Ответ:

{
"status": 200,
"body": {
"translationId": "2017",
"status": "finished",
"startDate": "2023-09-26T12:00:29Z",
"endDate": "2023-09-26T12:58:59Z"
}
}

status принимает значения: planned, online, finished.

Аутентификация

Эндпоинт quick-state публичный, поэтому applicationId не требуется. Если вы участвуете в бете токенов, можно добавить заголовок Authorization: Bearer ... — клиент автоматически сопоставится.

Лучшая практика

  • Кэшируйте deep links на стороне клиента и обновляйте только после изменения status в quick-state.
  • Для магазинов с большим трафиком ограничьте частоту опроса quick-state до 1 запроса в 10 секунд.
  • В веб-приложениях добавляйте utm_source/utm_medium в deep link, чтобы отслеживать конверсию в аналитике.

Далее — deep links и мобильные SDK.