Artifact-first
Как устроена интеграция ShopStory
На схеме показана общая логика сервиса: слева контур ShopStory (кабинет и мобильное приложение для запуска эфиров), справа контур клиента (список эфиров, плеер, мини-плеер и live-виджет на сайте/в приложении). Документация ниже объясняет, как связать эти части в рабочей интеграции.
ShopStory Docs
SDK-first документация для e-commerce интеграций
Основной путь для новых клиентов — Web SDK. В документации сохранены оба формата: быстрый SDK и кастомная API-интеграция, с явным разделением по сложности, ответственности и срокам внедрения.
- Внедрение SDK
- 5-15 минут
- Основной сценарий mobile
- WebView + `wv=1` + `safe_area=1`
- Поддержка
- support@shopstory.live
Integration reality
Что должна закрыть команда клиента
Подключить SDK-скрипты
Страница стримов + mini-player/live-widget. Без API-запросов на старте, но с корректным размещением контейнеров и шаблонов PDP.
Подготовить mobile WebView
Запуск по URL с `wv=1`, на устройствах с вырезом — `safe_area=1`, кнопка закрытия реализуется в нативном приложении.
Обработать bridge-события
Реализовать `add-product` и `open-product` в iOS/Android, чтобы кнопка «Купить» и переход в карточку не терялись внутри WebView.
Пройти эксплуатационную проверку
Проверить Network/Console, сверить SKU с фидом, зафиксировать сценарий live.
Decision matrix
SDK и API: различия по затратам и ответственности
| Критерий | Web SDK | Public API |
|---|---|---|
| Время запуска | 5-15 минут | 1-3 дня разработки |
| UI контроль | Ограниченный | Полный |
| Mobile path | WebView URL + bridge | Нативная логика поверх API |
| Риск внедрения | Низкий при корректном фиде | Средний/высокий (архитектурная работа) |
| Кому подходит | Быстрый запуск в e-commerce | Командам с кастомным продуктовым UI |
SDK priority
Маршрут для нового клиента
API toolkit