API-ключ Wildberries и Ozon: где взять

Что такое API-ключ и зачем он продавцу

API-ключ — это ключ доступа к вашему кабинету продавца на маркетплейсе. С его помощью сторонняя программа подключается к площадке и работает с данными от вашего имени. Пароль от кабинета при этом передавать никому не нужно.

У площадок ключи устроены по-разному. У Wildberries это токен — одна длинная строка, которую вы создаёте в кабинете WB. У Ozon это два значения: Client-Id и Api-Key. Оба выдаются в кабинете продавца Ozon Seller и используются вместе.

Зачем это продавцу: вместо ручной работы с кабинетом сервис по ключу читает отзывы и вопросы, переносит карточки и синхронизирует остатки ФБС. Вы один раз подключаете магазин, а дальше нужные действия идут автоматически, а вы только проверяете результат.

Ключ — это не логин, а именно доступ для программы. Поэтому его можно в любой момент отозвать в кабинете площадки, не меняя пароль и не задевая вход в личный кабинет.

Где взять API-ключ Wildberries

API-ключ Wildberries (токен) создаётся в личном кабинете продавца. Войдите в кабинет, откройте «Профиль» и пункт «Интеграции по API». В части кабинетов он называется «Доступ к API» — название пункта в вашем кабинете может отличаться.

Нажмите кнопку создания токена и отметьте нужные категории доступа. Для полного набора функций подойдут «Контент», «Цены и скидки», «Маркетплейс» (заказы и остатки FBS) и «Вопросы и отзывы» — для каждой категории выберите «Чтение и запись». Затем создайте токен.

Токен показывается один раз. Сразу скопируйте его в надёжное место: позже в кабинете WB значение не отображается. Срок действия токена ограничен, поэтому со временем потребуется перевыпуск и повторное добавление в сервис.

Если нужна только часть функций, достаточно соответствующих категорий доступа — сервис подскажет, каких прав не хватает, если вы отметили не всё.

Где взять API-ключ Ozon

API-ключ Ozon — это пара Client-Id и Api-Key. Оба значения создаются в кабинете продавца на seller.ozon.ru. Войдите в кабинет, откройте «Настройки» и пункт «API ключи» — название пункта в вашем кабинете может отличаться.

Нажмите «Добавить ключ» и сразу скопируйте Client-Id и Api-Key: они понадобятся сразу при подключении. Это разные поля, менять их местами нельзя, иначе ключ не сработает.

Для ключа нужна роль Admin. Подойдут и другие роли, если они дают доступ к товарам, заказам FBS, отзывам и вопросам. Если роли не хватает, сервис вернёт ошибку доступа и подскажет, что проверить.

Если ключ перестал подходить, создайте новый в кабинете Ozon и обновите его в разделе «Интеграции» — старый можно смело отозвать.

Какие права нужны для переноса, ответов и остатков

Набор прав зависит от того, какие функции сервиса вы используете. Для переноса карточек нужен доступ к контенту и ценам: сервис читает данные вашей карточки и публикует её на площадке-приёмнике.

Для автоответов на отзывы и вопросы нужны доступ к отзывам и вопросам с правом записи — тогда сервис может отвечать покупателям от вашего имени. Для синхронизации остатков ФБС нужны заказы и остатки: так сервис видит продажи и обновляет остаток на обеих площадках.

Если отметить не все категории, часть разделов просто не заработает. Сервис подскажет, каких прав не хватает, а вы сможете начать с одной функции и расширить права позже, перевыпустив ключ.

Важное условие Ozon: доступ к API отзывов у Ozon открывается только при подключённой у продавца платной услуге Ozon «Управление отзывами» (Premium Pro). Это требование площадки, а не сервиса. Перенос карточек, заказы FBS и остатки Ozon работают и без неё.

Как хранить ключи и когда их отзывать

Относитесь к API-ключу как к паролю: кто получил ключ, тот может работать с вашим кабинетом. Не пересылайте токен WB и Api-Key Ozon в чатах, письмах и на скриншотах — лучше держите их в закрытом файле или менеджере паролей.

Создавайте отдельный ключ под наш сервис — так его проще отозвать, не задев другие программы. Следите за сроком действия токена WB: он ограничен, и после истечения нужен новый токен, иначе синхронизация и автоответы для Wildberries остановятся.

Отозвать доступ можно в любой момент в кабинете площадки: у Wildberries — в разделе «Интеграции по API» (Доступ к API), у Ozon — в разделе «API ключи». Отзыв ключа сразу прекращает доступ сервиса к данным магазина, даже если вы забыли удалить ключ у нас.

Если есть подозрение на утечку, сначала отзовите старый ключ на площадке, затем выпустите новый и добавьте его в раздел «Интеграции». Это быстрее и надёжнее, чем пытаться вернуть доступ прежним ключом.

Как ключи хранятся в сервисе

Сервис не запрашивает и не хранит пароли от кабинетов Wildberries и Ozon. Для работы нужны только API-ключи, которые вы создаёте сами в кабинетах площадок. Пароль от кабинета никому передавать не нужно.

Ключи площадок хранятся в зашифрованном виде: используется шифрование AES-256. В интерфейсе ключи показываются маской, полностью они не отображаются.

Сервис обращается к площадкам только для тех действий, которые вы включили: перенос карточек, автоответы на отзывы и вопросы, синхронизация остатков ФБС. Удалить ключи можно в разделе «Интеграции» в любой момент.

Как подключить магазин по шагам

Подключение занимает несколько минут. Сначала создайте ключ в кабинете площадки по шагам выше, затем перейдите в раздел «Интеграции» нашего кабинета.

Выберите нужный магазин — Wildberries или Ozon — и нажмите «Подключить». Вставьте токен WB или пару Client-Id и Api-Key Ozon и сохраните.

После сохранения статус магазина станет «Подключён». В разделе автоответов сервис начнёт видеть новые отзывы и вопросы, в разделе ФБС подтянутся товары и склады, а перенос начнёт видеть ваши карточки.

Оплата идёт за каждое действие, без абонентской платы: перенос карточки — 15 токенов, ответ на отзыв или вопрос — 1 токен, ответ в чате — 2 токена. Цена каждого действия видна заранее в кабинете.

Типичные ошибки при подключении

Ошибка 401 или 403 чаще всего означает, что ключ неверный или скопирован не полностью. Скопируйте токен WB или пару Client-Id и Api-Key Ozon заново и сохраните в разделе «Интеграции».

Если сервис пишет, что не хватает прав, — у ключа отмечены не все нужные категории или роль. В Wildberries перевыпустите токен и отметьте «Контент», «Вопросы и отзывы», «Маркетплейс»; в Ozon проверьте роль Admin и активную услугу «Управление отзывами» для отзывов.

Токен WB перестал работать — истёк срок действия. Создайте новый токен в кабинете WB и обновите его в сервисе. Ключ Ozon отозван — выпустите новый в кабинете Ozon.

Если ошибка сохраняется, проверьте, есть ли у вас в кабинете права на работу с API, и напишите в поддержку сервиса — подскажем, что поправить.

Связанные возможности