<!-- Canonical: https://docs.shopstory.live/docs/resources/changelog -->

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

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

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

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

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

- Руководство [Интеграция с интернет-магазином](<https://docs.shopstory.live/docs/guide/custom-commerce-integrations>) описывает товарные данные через фид, API магазина и их сочетание, выбор SKU, актуальные условия покупки, корзину и возврат к видео.
- Добавлены схемы источников товарных данных и подтверждения корзины, примеры структуры SKU и адаптера магазина. Callback корзины и boolean-обработчик наличия описаны отдельно от расширенного контракта.
- Уточнено значение `available` в фиде: отсутствие `false` в одной выгрузке не определяет возможности источника.

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

- Раздел [Наличие товара и остатки](<https://docs.shopstory.live/docs/guide/product-availability>) описывает обработчик наличия Web SDK: `actions.resolveProductsAvailability` и метод `ShopStorySDK.refreshProductsAvailability()`.
- Наличие и каталог разделены: обработчик определяет доступность покупки, каталог и цены остаются за товарным фидом.
- Описан приоритет источников для фидов, в которых `available="false"` означает вывод товара из ассортимента, а не отсутствие остатка.
- Зафиксировано поведение при недоступном stock API: пропущенный идентификатор означает «неизвестно», карточки остаются в состоянии по фиду, воспроизведение не прерывается.
- Обработчик наличия входит в Web SDK. Вызов API со стороны ShopStory, серверный посредник и нестандартные контракты корзины согласуются отдельно.
- Public API не получил новых методов: HTTP-эндпоинта проверки остатков нет.
- Уточнены описания в [Товарном фиде](<https://docs.shopstory.live/docs/guide/feed-requirements>), [Каталоге эфиров](<https://docs.shopstory.live/docs/guide/catalog-streams>), [Добавлении в корзину](<https://docs.shopstory.live/docs/guide/add-to-cart>), [Web SDK](<https://docs.shopstory.live/docs/guide/web-sdk>), [Mobile SDK](<https://docs.shopstory.live/docs/guide/mobile-sdk>) и OpenAPI-спецификации.

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

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

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

- Актуальные поля и обязательность параметров: [OpenAPI](<https://docs.shopstory.live/docs/reference/openapi>).
- Порядок обработки ответа: [Формат запросов и ответов](<https://docs.shopstory.live/docs/guide/architecture>).
- Поведение готовых web-компонентов: [Web SDK](<https://docs.shopstory.live/docs/guide/web-sdk>).
- Нативное товарное видео и граница mobile commerce: [Mobile SDK](<https://docs.shopstory.live/docs/guide/mobile-sdk>).
- Изменения пакета, корзины и остатков для конкретного клиента входят в его приложение к интеграции.

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