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

Интеграция мини-плеера и 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.