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

История публичной документации

Здесь перечислены изменения руководств, примеров и публичных контрактов, которые влияют на интеграцию с ShopStory.

23 октября 2026 — инструкции по платформам и аналитике​

  • Web, Mobile и Public API получили собственные маршруты чтения. Методы Web SDK, Web mini-player, native iOS и Flutter вынесены в отдельные инструкции.
  • Добавлены готовые примеры с исходным кодом, термины и таблица идентификаторов.
  • Опубликованы версии SDK, к которым относятся примеры, правила обновления и rollback.
  • Добавлены руководства по смыслу метрик, Яндекс Метрике, GA4, UTM и AppMetrica. Клик, подтверждение корзины и заказ описаны отдельно.
  • Уточнены границы стандартной проверки наличия и проектного commerce-контракта. OpenAPI согласован с руководствами.

29 сентября 2026 — руководство по интеграции с интернет-магазином​

  • Руководство Интеграция с интернет-магазином описывает товарные данные через фид, API магазина и их сочетание, выбор SKU, актуальные условия покупки, корзину и возврат к видео.
  • Добавлены схемы источников товарных данных и подтверждения корзины, примеры структуры SKU и адаптера магазина. Callback корзины и boolean-обработчик наличия описаны отдельно от расширенного контракта.
  • Уточнено значение available в фиде: отсутствие false в одной выгрузке не определяет возможности источника.

7 сентября 2026 — наличие по выбранному магазину​

  • Раздел Наличие товара и остатки описывает обработчик наличия Web SDK: actions.resolveProductsAvailability и метод ShopStorySDK.refreshProductsAvailability().
  • Наличие и каталог разделены: обработчик определяет доступность покупки, каталог и цены остаются за товарным фидом.
  • Описан приоритет источников для фидов, в которых available="false" означает вывод товара из ассортимента, а не отсутствие остатка.
  • Зафиксировано поведение при недоступном stock API: пропущенный идентификатор означает «неизвестно», карточки остаются в состоянии по фиду, воспроизведение не прерывается.
  • Обработчик наличия входит в Web SDK. Вызов API со стороны ShopStory, серверный посредник и нестандартные контракты корзины согласуются отдельно.
  • Public API не получил новых методов: HTTP-эндпоинта проверки остатков нет.
  • Уточнены описания в Товарном фиде, Каталоге эфиров, Добавлении в корзину, Web SDK, Mobile SDK и OpenAPI-спецификации.

4 сентября 2026 — обновление структуры и контрактов​

  • Разделы расположены в порядке выбора метода, подключения, контрактов, commerce-сценариев и эксплуатации.
  • Перед подключением Web SDK нужно зарегистрировать домены в ShopStory и получить конфигурацию проекта.
  • Обработка ответа учитывает HTTP-код и status внутри JSON-конверта.
  • Для кастомной корзины и проверки актуальных остатков описана публичная граница интеграции.
  • Раздел Mobile SDK теперь описывает product entrypoint, встроенный плеер, follow-me и типизированные commerce-действия.
  • Контракты Web callback и mobile action описаны отдельно.

Где искать текущий контракт​

  • Актуальные поля и обязательность параметров: OpenAPI.
  • Порядок обработки ответа: Формат запросов и ответов.
  • Поведение готовых web-компонентов: Web SDK.
  • Нативное товарное видео и граница mobile commerce: Mobile SDK.
  • Изменения пакета, корзины и остатков для конкретного клиента входят в его приложение к интеграции.

Если наблюдаемое поведение расходится со справочником, передайте endpoint, безопасный фрагмент ответа, время запроса и applicationId на support@shopstory.live. Пароли, cookies и токены в обращение не включайте.

Последнее обновление