Первый запрос за 15 минут

Эта инструкция рассчитана примерно на 15 минут — от создания токена до первого ответа WB API. Четыре шага: получите токен, добавьте его в заголовок, проверьте подключение и запросите реальные данные. Предварительный опыт не нужен — только доступ в личный кабинет WB Партнёры и терминал.

Запросы к WB API авторизуются по токену. Вы передаёте токен в заголовке Authorization, API проверяет его и возвращает ответ. Тот же принцип авторизации используется и при вызове других методов.

Шаг 1. Получите токен

Токен — ключ для авторизации каждого запроса. Создайте его в личном кабинете WB Партнёры.

Ещё нет личного кабинета? Общий порядок получения доступа описан в материале «Как начать работать с WB API: от регистрации до токена». Условия регистрации зависят от страны.

1. Войдите в личный кабинет WB Партнёры и откройте раздел «Интеграции по API».
2. Создайте токен. Для работы со своим магазином выберите тип «Базовый» или «Персональный», любую категорию данных и уровень доступа — «Только чтение» или «Чтение и запись». Для запросов ниже подходит «Только чтение». Тестовый токен работает только с песочницей и для этой инструкции не подходит.
3. Скопируйте токен целиком и сразу сохраните его. Он показывается только один раз, восстановить его нельзя — если потеряете, создайте новый.

Токен — длинная строка. Скопируйте её целиком, без лишних пробелов и переносов строк: неполный токен не подойдёт для авторизации.

---

Шаг 2. Добавьте заголовок Authorization

Для авторизации передайте токен в заголовке Authorization — для двух GET-⁠запросов ниже других заголовков не требуется.

Отдельный вход в API и сессия для этих запросов не нужны. Каждый запрос содержит токен. В curl для этого используется параметр -H "Authorization: YOUR_TOKEN"; в любом HTTP-клиенте — заголовок Authorization, значение которого — токен.

Не добавляйте токен в журналы, скриншоты и код, которым делитесь с другими. Храните его так же бережно, как пароль.

---

Шаг 3. Проверьте подключение GET-⁠запросом

Начните с самого простого вызова — метод «Проверка подключения» (/ping) проверяет, что запрос доходит до WB API и токен действителен. Он не возвращает данные магазина и ничего не меняет.

Замените YOUR_TOKEN своим токеном и выполните команду в терминале; на Windows команды с переносом строки через обратную косую черту выполняются в Git Bash или WSL:

curl -X GET "https://common-api.wildberries.kg/ping" \
  -H "Authorization: YOUR_TOKEN"

Пример успешного ответа:

{
  "Status": "OK",
  "TS": "2026-07-01T10:00:00Z"
}

"Status": "OK" — ваш первый успех: подключение работает, токен принят.

---

Шаг 4. Получите реальные данные и прочитайте ответ

Теперь запросите реальные данные — метод «Получить информацию о продавце» (/api/v1/seller-info) возвращает наименование и идентификаторы продавца. Он также работает с любой категорией данных Базового или Персонального токена и ничего не меняет.

curl -X GET "https://common-api.wildberries.kg/api/v1/seller-info" \
  -H "Authorization: YOUR_TOKEN"

Пример успешного ответа — JSON с данными вашего магазина:

{
  "name": "Example LLC",
  "sid": "a1b2c3d4-0000-0000-0000-000000000000",
  "tin": "1234567890",
  "tradeMark": "Example"
}

Ответ API состоит из трёх частей:

• HTTP-код ответа — результат запроса. 200 означает успех, данные находятся в теле ответа. 4XX означает ошибку запроса или доступа; 5XX — ошибку на стороне сервера.
• Тело ответа — данные в формате JSON при успешном запросе или описание ошибки.
• Заголовки ответа — служебная информация о запросе.

Так выглядит полный цикл: адрес метода, заголовок Authorization и JSON в ответе. Для других методов принцип авторизации тот же. Если вы отправляете тело запроса в формате JSON, добавьте заголовок Content-Type: application/json. Некоторые методы используют другие форматы или дополнительные заголовки — они указаны в описаниях методов.

---

Если вместо ответа пришла ошибка 401

Код 401 означает, что авторизация не прошла.

Проверьте по порядку:

• Токен скопирован целиком — без пропущенных символов в начале или конце. При необходимости скопируйте его заново.
• В значении заголовка нет лишних пробелов и переносов строк.
• У токена не истёк срок действия и он не удалён. Если токен больше не действует, создайте новый в личном кабинете WB Партнёры.

Исправьте заголовок и повторите тот же запрос /ping. Ответ "Status": "OK" подтверждает подключение, но не гарантирует успех seller-info: у него свои лимиты. Для Базового токена разрешён один запрос за 24 часа. Если пришёл 429, лимит исчерпан — повторите запрос позже.

---

Что можно сделать дальше