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

ЧаВо интеграторов

Как получить данные для аутентификации?​

Обратитесь к вашему менеджеру или напишите на support@shopstory.live. Сейчас выдаётся applicationId для production и тестовых окружений. Bearer токены запланированы на лето 2026 — когда они станут публичными, мы уведомим всех клиентов и обновим гайд по аутентификации.

Поддерживаете ли вы GraphQL?​

Публичный API основан на REST. Для внутренних систем можно обсудить GraphQL-обёртку с командой ShopStory.

Что делать, если я использую applicationId?​

Так и должно быть: applicationId — текущий production-метод. Подготовьте код к будущей миграции (см. гайд по аутентификации), чтобы быстро переключиться на Bearer токены после релиза.

Как быстро обновляются данные каталога?​

Данные становятся доступными в /v3/streams через 1–2 секунды после публикации трансляции. Для live-событий используйте quick-state.

Где посмотреть историю изменений?​

Следите за разделом Changelog; там фиксируются все изменения API и документации.

Почему /v2/ использует application=, а /v3/ — applicationId=?​

Исторически разные версии API используют разные имена параметра. Оба варианта корректны в рамках своей версии: application= для /v2/-эндпоинтов (например, mini-player), applicationId= для /v3/-эндпоинтов (например, streams). При copy-paste примеров убедитесь, что используете параметр, соответствующий версии API. Подробнее — в разделе Архитектура.

Что делать при 404 от /v2/mini-player/stream?​

Обычно это означает, что товар не привязан к стриму или SKU в запросе не совпадает со значением feedProductId из товарного фида. Проверьте, что feedProductId в URL совпадает с id товара в вашем XML/YML-фиде. Подробнее — в разделе Mini-player.

Как тестировать интеграцию без live-стрима?​

Используйте записи завершённых трансляций (status=finished) — они доступны через те же API-эндпоинты. Для проверки real-time обновлений используйте quick-state. Подробнее — в Quickstart и Mini-player.

Какой timezone у serverTime?​

serverTime возвращается в формате UTC (ISO 8601). Все даты в API — UTC. При отображении пользователю конвертируйте в локальный timezone на клиенте. Подробнее — в разделе Архитектура.

Как обрабатывать ошибки внутри JSON-конверта (HTTP 200, но status ≠ 200)?​

ShopStory API использует JSON-конверт: HTTP-ответ всегда 200, а реальный статус — в поле status внутри JSON. Проверяйте status внутри тела ответа, а не HTTP-код. Пример обработки — в разделах Quickstart и Кэширование.

Связанные разделы​

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