Api ключ на вайлдберриз что это
Перейти к содержимому

Api ключ на вайлдберриз что это

API ключ Вайлдберриз

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

Мы поддерживаем два типа API ключей Вайлдберриз:

  1. Ключ API статистики x64 — обязателен, нужен для загрузки данных статистики
  2. Ключ нового API — не обязателен, нужен для SEO анализа карточек и продаж со своего склада (FBS)

Как получить ключ API статистики x64 Wildberries:

  1. Откройте личный кабинет партнера на сайте Wildberries по адресу seller.wildberries.ru
  2. Войдите под главным пользователем аккаунта
  3. Кликните по названию юр. лица в правом верхнем углу страницы, далее выберите «Настройки» &gt «Доступ к API»
  4. Если в разделе нет ни одного ранее добавленного ключа API, нажмите «Сгенерировать ключи» и добавьте новый ключ
  5. Скопируйте из поля «Ключ для работы с API статистики x64» значение ключа (длинную последовательность из букв и цифр), нажав кнопку справа от ключа
  6. Вставьте ранее скопированное значение ключа в поле «Ключ API статистики x64» на странице добавления магазина в SellerStats

Как получить ключ нового API Wildberries:

  1. Откройте личный кабинет партнера на сайте Wildberries по адресу seller.wildberries.ru
  2. Войдите под главным пользователем аккаунта
  3. Кликните по названию юр. лица в правом верхнем углу страницы, далее выберите «Настройки» &gt «Доступ к новому API»
  4. Введите произвольное имя токена и нажмите «Сгенерировать токен»
  5. Скопируйте из поля «Токен для работы с API» значение ключа (длинную последовательность из букв и цифр), нажав кнопку справа от ключа
  6. Вставьте ранее скопированное значение ключа в поле «Ключ нового API» на странице добавления магазина в SellerStats

Первоначальная загрузка данных

После добавления магазина статистика появится в течение 15 минут. По умолчанию статистика загружается за последние 90 дней с даты добавления магазина, но не ранее даты создания ключа API статистики x64 (ограничение Вайлдберриз).

Как получить API Wildberries и что с ним делать?

Аббревиатура API расшифровывается как «Application Programming Interface» (интерфейс программирования приложений, программный интерфейс приложения) – это набор готовых классов, функций, процедур, структур и констант. Вся эта информация предоставляется самим приложением (или операционной системой). При этом пользователю не обязательно понимать, что это API технология обеспечивает взаимодействие модулей. Цель предоставленной информации – использование этих данных при взаимодействии с внешними программами.

Допустим разработчикам, поставщикам маркетплейсов (об этом чуть позже) или же обычному пользователю не нужно знать, как работает та или иная платформа (Facebook, VK, Wildberries, Ozon и другие…). Но благодаря API, обыденный пользователь может публиковать статьи нужных пользователей в своём приложении. Разработчик без проблем сможет делать интеграции в код. Поставщику быстрее и удобнее работать с данными маркетплейсов, даже не вникая в принцип работы API.

Пример для обычного обывателя

Приведу простую аналогию. У вас есть розетка и допустим компьютер. Для того, чтобы компьютер заработал, вам нужно его подключить к сети. Так вот, в данном случае «Сеть» можно назвать программой, от которой мы берем все необходимые данные, соответственно «розетка» выступает аналогом API. Обратите внимание, что розетки бывают разные (как по типу, так и по напряжению), исходя из этого будет отличаться сам интерфейс API и предоставляемая ею информация.

interface apiПринцип работы API

Многие компании предлагают API как готовый продукт и зачастую являются платными. Например, Weather Underground продаёт доступ к своему API для получения метеорологических данных. Таких сервисов можно привести большое множество. Имеются сервисы и с бесплатным доступом с API, однако многие из них предоставляют лишь базовый набор функций. Возможен вариант, когда API разрабатывается исключительно для внутренних нужд отдельной компании и является полностью закрытым.

Ну и наконец, постепенно мы дошли до таких сервисов как маркетплейсы. Собственно говоря из-за чего и написана данная статья. На сегодняшний день их становится всё больше, но гигантами на Российском рынке остаются Wildberries, Ozon, Янедекс.Маркет (Беру!), Goods и частично Aliexpress (представитель Tmall). Все эти площадки предоставляют API в открытом доступе и совершенно бесплатно. Благодаря этому поставщики, пользуясь сторонними сервисами, могут свободно анализировать свои данные, будь то заказы, продажи, логистика и многие другие аспекты аналитики. К примеру сервис разработанный нами ECHelper и другими аналогичными программами или же прямым запросом в браузере (для этого требуются необходимые навыки).

Доступ к API в Wildberries

Многие при регистрации на нашем сервисе, застревают на моменте ввода API ключа, так как его у них нет и как получить, тоже не знают. Так как мы пока работаем только с Wildberries, с него и начнем. Давайте подробно пройдёмся по цепочке получения данного ключа, а тем, кому будет лень читать, просьба пролистать ниже к краткому видео обзору или скачать инструкцию ТУТ.

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

Новый портал

Заходим в раздел «Настройки» в меню слева под выбором языка. В открывшейся вкладке справа кликаем на пункт «Доступ к API».

доступ к API Wildberries

Если вы ранее не генерировали ключи, система вам предложит их сгенерировать.

генерация API ключа вайлдберриз

После генерации, у вас появится 2 API ключа для работы с 32-разрядной и 64-разрядной системой.

готовые API ключи wildberries

Уточняю, для работы с нашим сервисом вам нужен ключ именно 64-разрядный.

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

Старый портал

Способ получения API ключа на старой версии личного кабинета. Здесь процесс получения тоже не сложный, но более длительный. Заходим в раздел Service Desk, жмём вкладку «Создать Заявку».

service desk Wildberries

В пункте «Категория» выбираете «Поддержка». Для «Тема» выбираете «Поддержка/Консультация». Заполните поле «Комментарий» следующим текстом: «Здравствуйте! Могли бы вы мне предоставить API-ключ для интеграции? Спасибо!» и нажмите кнопку «Создать заявку».

заявка на api ключ Вайлдберриз

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

Учтите, что после подключения ключа к нашему сервису, данные о товарах будут доступны только с момента получения первого API ключа. К примеру, если вы получили ключ 01 января, то в сервисе данные будут показываться, начиная с 01 января.

Короткий видео обзор, как получить API ключ Wildberries?
Доступ к API в Ozon

В личном кабинете поставщика в правом верхнем углу заходим в «Настройки», для этого наведите на «человечка».

доступ к api Ozon

В открывшейся странице, переходим в меню «API ключи» и генерируем необходимый вам ключ. Чтобы сгенерировать API , выберите тип токена и введите название ключа. Для работы со сторонними сервисами, нужно создавать API ключ с типом токена «Администратор».

генерация API ключа Озон

Доступ к API в Goods

В личном кабинете поставщика в левом меню нажимаете на «Настройки» -> «Интеграция по API»

доступ к API key Goods

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

генерация Api ключа Гудс

Доступ к API в Яндекс.Маркет

В личном кабинете Яндекс.Маркета нужно указать настройки доступа. Заходим в раздел “Маркет для магазинов” Яндекса и нажимаем на имя вашего магазина. Выбираем в меню с лева Работа с API -> Настройки API заказа

доступ к API Яндекс.Маркет

На открывшейся странице задаем следующие настройки:

генерация Api key Yandex Market

Авторизационный токен – это ключ API для доступа к Яндекс.Маркету . Чтобы получить его, нажмите “изменить” рядом с полем, и система сгенерирует ключ.

Отрывок статьи взят с сайта UCOZ. Подробнее ознакомиться можно ТУТ!

Доступ к API в Aliexpress

В панели управления партнерским аккаунтом, переходим в меню AdCenter -> API Setting и жмем кнопку Apply Now

доступ к API Aliexpress

После этого — Aliexpress будет обрабатывать Вашу заявку и в течении 5-10 рабочих дней появится API ID и секретный ключ для доступа к товарам. После того, как будет подтвержден Ваш аккаунт Вы увидите в меню AdCenter -> API Setting следующие данные:

генерация API key Aliexpress

Отрывок статьи взят с сайта OPENMALL. Подробнее ознакомиться можно ТУТ!

Разбор проблем Wildberries API, от разработчика-фрилансера

Разработчик-фрилансер, с опытом работы 2 года, а так же с большим количеством разного api (paypal, vk, moysklad и т. д.).

В этой статье, я не претендую на экспертность, а просто хочу рассказать свое субъективное мнение, об очень существенных на мой взгляд недостатках wildberries api.

Первое

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

Так же, я долго не мог понять, почему мой токен не подходит ко второй версии документации, а удалось мне это понять, только во время обсуждений в неофициальном чате разработчиков. Оказывается, что для этого нужно получать другой токен, во вкладке которая отображается только у владельца аккаунта. Как можно понять, владельцем аккаунта далеко не вседга является разработчик которому требуется апи wildberries. При этом, что более важно, об этом нету ни одного слова в документации.

Ошибки

429 (слишком частые запросы), появляется даже если я делаю запрос с перерывом в несколько минут. В чем её причина, можно только гадать. При обычном интервале в 3 секунды между тремя запросами — ошибка появляется практически при каждом запуске узла. При этом, никакой информации об ограничениях, в документации мне найти не удалось. Эта ошибка наиболее сильно мешает нормальной работе.

500 (ошибка сервера), стандартная ошибка, встречается почти в любых апи. Но очень хочется, что бы был отдельный канал в который будут приходить уведомления о работах на сервере или о внештатных ситуациях, и предполагаемом времени их решения.

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

Авторизация

Нельзя сгенерировать разные токены, с разными правами, для разных пользователей.

Нету возможности, обновления токена при новых запросах.

Функционал

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

Не хватает возможности, получать остатки/продажи товаров по Конкретному региону или складу/списку складов.

Синтаксические ошибки

Например в документации (не полная) указан ключ Date, но от сервера приходит словарь с ключом date. В полной документации такой ошибки нету.

Возможно только я с ними столкнулся, но как минимум два бага, сейчас не дают закончить проект на финишной прямой.

в остатках товара на складе, на сайте указано одно число, а в апи приходит другое. (на сайте остаток по номенклатуре N, на складе N — 7, а с апи приходит — 1)

не получается пройти авторизацию к апи из второй документации (v2).Инструкций для этого нету. И даже если пробовать делать запросы через формы на сайте, то в ответ приходит ошибка «Invalid token».

Техническая поддержка

Найти техническую поддержку именно для разработчиков мне не удалось. Сколько еще багов они не исправляют из-за этого, можно только гадать. Ибо многие просто перестают работать с их апи, или находят несоразмерно сложные решения, не обращаясь в тех поддержку из-за сложностей связанных с этим процессом именно в wildberries.

Одной из предполагаемых причин ошибки 429, является работающий у меня VPN, в таком случае, хотелось бы получать информацию об ошибке из-за слишком частых запросов с одного IP.

Если у кого-то либо возникает желание порекомендовать отключить VPN, или отключить его для WB Api, то вам нужно понимать, что я использую VPN для защиты передаваемых в сеть данных, в связи с периодическими новостями о найденных в роутерах уязвимостях позволяющих получить злоумышленникам полный контроль над роутером, что в свою очередь позволяет перехватывать все отправляемые в сеть данные, в связи с чем я предпочитаю передавать данные в недоступном для злоумышленников виде, до первого относительно безопасного узла, коим и является VPN.

Написал этот пост без агрессии или претензий, а с надеждой на изменение wb api в лучшую сторону. Так же надеюсь этот будет полезен тем, кто проектирует новое апи.

Добавить комментарий

Ваш адрес email не будет опубликован.