Выберите вариант интеграции сервиса
Web SDK
Минимальный time-to-market. Каталог стримов, mini-player и live-widget без ручной серверной интеграции на старте.
- Срок: часы, не дни
- Риск: низкий при корректном фиде
- Кому: продуктовые команды с приоритетом запуска
Public API
Полный UI-контроль и собственная серверная логика. Выше стоимость внедрения и эксплуатационная ответственность.
- Срок: 1-3 дня на baseline
- Риск: средний/высокий
- Кому: командам с кастомным фронтом и backend
Запуск live-commerce интеграции без лишней архитектуры
Документация построена вокруг практического выбора: быстрый запуск через Web SDK или кастомный контур через Public API. Сценарии разделены по срокам, риску и требованиям к команде.
- Старт SDK
- 5-15 минут до первого результата
- Mobile-контракт
- WebView + `wv=1` + `safe_area=1` + bridge
- Эскалация
- support@shopstory.live
Что команда должна закрыть до production
Подключить SDK-скрипты
Поднять страницу стримов и проверить загрузку `shopstory-sdk` и `shopstory-pip` без конфликтов с шаблонами PDP.
Подготовить mobile WebView
Зафиксировать URL-контракт: `wv=1`, а для устройств с вырезом `safe_area=1`. Кнопка закрытия реализуется в нативном слое.
Обработать bridge-события
Реализовать `add-product` и `open-product` в iOS/Android, чтобы переходы в карточку товара не терялись в WebView.
Проверить эксплуатационный контур
Пройти smoke-тесты, проверить mapping SKU/фида и зафиксировать сценарий мониторинга перед релизом.
SDK и API: различия по затратам и ответственности
| Критерий | Web SDK | Public API |
|---|---|---|
| Время запуска | 5-15 минут | 1-3 дня разработки |
| UI контроль | Ограниченный | Полный |
| Backend нагрузка | Минимальная на старте | Обязательный proxy + обработка ошибок |
| Mobile path | WebView URL + bridge | Нативная логика поверх API |
| Кому подходит | Быстрый запуск в e-commerce | Командам с кастомным продуктовым UI |