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

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

В список входят изменения, которые влияют на работу внешнего интегратора. Перед публикацией ShopStory сверяет руководство, OpenAPI и реализованное поведение. Внутренние релизы продукта сюда не входят.

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

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

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

  • Разделы расположены в порядке выбора метода, подключения, контрактов, commerce-сценариев и эксплуатации.
  • Перед подключением Web SDK нужно зарегистрировать домены в ShopStory и получить конфигурацию проекта.
  • Quickstart больше не содержит интерактивного production Playground, фиксированных количеств данных и требования скрывать applicationId как секрет.
  • Обработка ответа учитывает HTTP-код и status внутри JSON-конверта.
  • Для кастомной корзины и проверки актуальных остатков описана публичная граница интеграции.
  • Раздел Mobile SDK теперь описывает product entrypoint, встроенный плеер, follow-me и типизированные commerce-действия.
  • Контракты Web callback и mobile action описаны отдельно. Координаты пакетов, точные версии, клиентские routes и сигнатуры остаются в integration handoff.
  • Статическая страница без подключения к реальному мониторингу удалена.
  • Неподтверждённые сроки внедрения, сроки ответа поддержки и будущие даты релизов удалены.
  • QA сайта стал обязательной стадией CI для main и merge request.

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

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

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

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