Зачем нужен Hub, если у WB уже есть API-ключ

Первый вопрос, который задаёт почти каждый продавец при подключении: «у Wildberries есть API, зачем мне ещё ставить какое-то приложение на компьютер». Вопрос закономерный — API действительно есть, и часть данных через него приходит быстро и без всякого Hub. Проблема в слове «часть». У обеих площадок есть данные, которые публичный API просто не отдаёт, и единственный способ их забрать — зайти в тот же личный кабинет, в который заходите вы сами, глазами и мышкой. Автоматизировать это может либо человек каждый день вручную, либо приложение, которое делает то же самое за него. UVIX Hub — второе.

Что даёт API-ключ Wildberries

Для Wildberries в UVIX используется API-ключ с доступом только на чтение — кабинет ничего не пишет обратно в ваш личный кабинет WB, только забирает данные. По этому ключу приходит заметная часть того, что нужно для РНП: заказы, часть финансовых операций, остатки, реклама. Ключ создаётся в личном кабинете WB самим продавцом, и это самый простой и предсказуемый способ подключения — без установки чего-либо на компьютер.

Чего API не отдаёт

Проблема в том, что не весь финансовый отчёт Wildberries доступен по API. Часть отчётности площадка показывает только в веб-интерфейсе личного кабинета — так устроена сама площадка, и это не ограничение UVIX и не временный сбой интеграции. Если данные в принципе не отдаются по API, их нельзя забрать API-запросом, сколько бы раз его ни повторить. Единственный способ увидеть эти цифры — открыть тот же самый экран в браузере, который видите вы, когда заходите в кабинет WB сами.

Зачем тогда Hub

Hub — это приложение для Windows, которое ставится на компьютер продавца и умеет открывать веб-интерфейс личного кабинета так же, как это делает обычный браузер, потому что внутри у него встроен браузерный движок. Из-за этого движка установщик получается тяжёлым — около 560 МБ, — и это честная плата за то, что Hub может добраться до данных, которых нет ни в одном API. Он не заменяет API-ключ Wildberries, а дополняет его именно там, где ключа физически недостаточно.

Как это выглядит на практике для WB

Для Wildberries Hub не спрашивает у вас логин и пароль от личного кабинета — таких полей в нём нет вообще. Вход в кабинет WB внутри Hub выполняется вручную: вы нажимаете кнопку «Открыть в браузере» и заходите в свой кабинет так же, как заходили бы в обычном окне браузера, тем способом, который сами считаете безопасным (обычно это уже сохранённая сессия или ваш привычный вход). Hub в этот процесс не вмешивается и ничего не подставляет за вас — он лишь открывает нужный экран внутри своего окна и забирает то, что на нём видно.

Lamoda — другой случай целиком

С Lamoda ситуация принципиально другая: публичного API для селлеров у площадки нет вовсе, поэтому там Hub — не дополнение к ключу, а единственный способ подключения. Вход в личный кабинет Lamoda выполняется логином и паролем прямо внутри Hub, и иногда при входе площадка показывает капчу — это поведение самой Lamoda, а не особенность интеграции. Из-за этого первое подключение Lamoda обычно требует немного больше внимания, чем добавление ключа WB; об этом отдельно — в статье про первое подключение Lamoda через Hub.

Что это значит для безопасности доступов

Разница в схемах подключения — не случайность, а прямое следствие того, что отдают площадки. Для WB достаточно ключа с правом только на чтение — это ограниченный, отзываемый доступ, который вы выдаёте сами и можете забрать в любой момент из своего кабинета WB. Для Lamoda, где ключа не существует в принципе, вход неизбежно завязан на логин и пароль — что именно из этого видит Hub и куда уходят эти данные, разобрано отдельно в статье что видит Hub в личном кабинете и что не передаёт наружу.

Здесь же стоит сразу закрыть смежный вопрос: помимо Hub у UVIX есть отдельное браузерное расширение UVIX Agent для вспомогательных сценариев. Это не второй способ решить ту же задачу, а инструмент для других случаев — разница разобрана в статье Hub и браузерное расширение: чем отличаются.

Как это устроено в UVIX

В UVIX Wildberries подключается связкой из двух источников: API-ключ с доступом только на чтение закрывает бо́льшую часть данных, а Hub добирает то, что видно исключительно в личном кабинете площадки. Для Lamoda, у которой открытого API нет, Hub — единственный канал целиком. Оба способа собираются в один РНП по товару, цвету и размеру, а не остаются двумя разными таблицами. Подробнее о том, что именно берётся по ключу, а что через Hub, — на странице интеграции с Wildberries.

Итог

API-ключ и Hub решают разные задачи, а не дублируют друг друга. Ключ — быстрый и ограниченный доступ на чтение к тому, что площадка отдаёт по протоколу. Hub — способ добраться до того, что площадка показывает только в веб-интерфейсе, а для Lamoda — единственный способ подключиться вообще. Ставить Hub «на всякий случай» не нужно, но без него часть отчёта Wildberries и вся Lamoda просто не соберутся.