Каталог стримов — GET /v3/streams

Основной endpoint для получения каталога трансляций и связанных справочников.

Запрос

GET https://app.shopstory.live/v3/streams?applicationId={your-app-id}&limit=20

Параметры:

Параметр	Обязательно	Описание
applicationId	Да	Идентификатор приложения
limit	Нет	Лимит выдачи (до 100)
offset	Нет	Смещение
feedProductId	Нет	Фильтр по товару из фида
categoryId	Нет	Фильтр по категории
status	Нет	planned, online, finished

Фильтры комбинируются по логике AND.

Ответ

{
  "status": 200,
  "serverTime": "2026-02-24T14:19:42.088410731Z",
  "body": {
    "plannedStreams": [],
    "availableStreams": [],
    "products": [],
    "streamers": [],
    "categories": [],
    "total": 0
  }
}

Модели в body

• plannedStreams[] — запланированные трансляции.
• availableStreams[] — live и завершенные трансляции.
• products[] — справочник товаров.
• streamers[] — справочник стримеров.
• categories[] — справочник категорий.
• total — итог по текущему фильтру.

Поведение ошибок (проверено на live)

По состоянию на 24 февраля 2026:

• без applicationId:
  • HTTP 200, status: 400, body.error: "invalid".
• неверный status (например completed):
  • HTTP 200, status: 400.
• нечисловой feedProductId:
  • HTTP 200, status: 200, обычно пустая выборка (total: 0).

Пример ошибки:

{
  "status": 400,
  "body": {
    "error": "invalid",
    "message": "invalid status"
  }
}

Практические рекомендации

1. Всегда проверяйте status из конверта, даже при HTTP 200.
2. Держите applicationId только на серверной стороне.
3. Не рассчитывайте на единственный формат body.error как объект с code.

Далее:

• Mini-player
• Architecture
• Caching