- Общее
- Введение
  - Как начать работу с API
  - Поддержка
  - Статус-коды HTTP
  - Лимиты запросов
- Авторизация
  - Правила использования токенов доступа к API
  - Как создать персональный, базовый или тестовый токен
  - Как устроен токен
  - Декодирование токена
- Проверка подключения к WB API
  - getПроверка подключения{{ /ping }}
- API новостей
  - getПолучение новостей портала продавцов{{ /api/communications/v2/news }}
- Информация о продавце
  - getПолучение информации о продавце{{ /api/v1/seller-info }}
- Управление пользователями продавца
  - postСоздать приглашение для нового пользователя{{ /api/v1/invite }}
  - getПолучить список активных или приглашённых пользователей продавца{{ /api/v1/users }}
  - putИзменить права доступа пользователей{{ /api/v1/users/access }}
  - delУдалить пользователя{{ /api/v1/user }}

API docs by Redocly

# Общее (general)

В этом разделе:

- общая информация о WB API
- как начать работу с WB API
- как авторизоваться и создавать токены
- основные статус-коды ответов
- лимиты запросов
- как обратиться в поддержку

С помощью методов этого раздела вы можете:

- проверить подключение к WB API
- получить новости портала продавцов
- получить информацию о продавце
- управлять пользователями продавца

## Общее

В этом разделе:

- общая информация о WB API
- как начать работу с WB API
- как авторизоваться и создавать токены
- основные статус-коды ответов
- лимиты запросов
- как обратиться в поддержку

С помощью методов этого раздела вы можете:

- проверить подключение к WB API
- получить новости портала продавцов
- получить информацию о продавце
- управлять пользователями продавца

## Введение

Wildberries API предоставляет продавцам инструменты для управления магазином и получения оперативной и статистической информации по протоколу HTTP REST API.

Главное преимущество API — возможность автоматизировать процессы за счет интеграции с информационными системами продавца: например, ERP, WMS, OMS, CRM. С WB API продавец может не управлять магазином через интерфейс сайта вручную.

Использование API для работы с магазином на Wildberries — это отличный способ:

- автоматизировать рутинные процессы
- получить доступ к актуальной информации
- оптимизировать управление ассортиментом

Документация API предоставлена в формате Swagger OpenAPI и может быть использована для импорта в другие инструменты — например, Postman — или генерации клиентского кода на различных языках программирования с помощью Swagger CodeGen.

Для ручного тестирования API вы можете использовать:

- Под ОС Windows — PostMan
- Под ОС Linux — curl

## Как начать работу с API

1. Зарегистрируйтесь в личном кабинете Продавца.
2. Перейдите в настройки магазина и создайте API-токен. Токен позволит получить доступ к WB API. Система токенов позволит вам контролировать, кто и как взаимодействует с вашими данными через API.
3. Разработайте интеграцию с API с помощью собственных разработчиков или внешних специалистов. Вы также можете подключить партнёрские сервисы из нашего каталога решений для бизнеса.

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

Практические советы:

- Используйте документацию.
  Официальная документация WB API поможет разобраться в функциональности и возможностях API. В ней приводятся примеры возможных запросов и ответов, список возможных ошибок, лимиты запросов, правила безопасности и так далее.
- Регулярно проверяйте работу интеграции.
  Следите, корректно ли вы передаете данные и какие вы получаете ответы, чтобы вовремя дорабатывать интеграцию. Не забывайте про ограничения и учитывайте лимиты на количество запросов.
- Храните API-токен в безопасности.
  Не передавайте его третьим лицам без необходимости. Используйте только доверенные сервисы. При обнаружении подозрительной активности немедленно удалите и замените токен.
- При необходимости обращайтесь в техническую поддержку.
- Следите за новостями и изменениями WB API в:
  - журнале изменений
  - Telegram-канале
  - новостной ленте Wildberries

## Поддержка

Техническая поддержка происходит через диалоги в личном кабинете продавца. При создании нового обращения в техподдержку используйте категорию API.

## Статус-коды HTTP

Основные статус-коды ответов на запросы в WB API:

Код | Описание | Как решить
--- | --- | ---
200 | Успешно |
204 | Удалено/Обновлено/Добавлено |
400 | Неправильный запрос | Проверьте синтаксис запроса
401 | Пользователь не авторизован | Проверьте токен авторизации. Категория токена должна совпадать с категорией API. Также токен может: • быть просрочен • быть некорректным • отсутствовать в запросе
403 | Доступ запрещён | Токен не должен быть сгенерирован удалённым пользователем. Доступ к методу не должен быть заблокирован. Если вы хотите использовать методы Джема, проверьте подписку в личном кабинете
404 | Не найдено | Проверьте URL запроса
409 | Ошибка сохранения для части ссылок/обновления статуса/добавления сборочного задания/т.д. | Проверьте данные запроса. Они должны отвечать требованиям и ограничениям сервиса
413 | Превышен лимит объёма данных в запросе | Уменьшите количество объектов в запросе
422 | Отсутствие в запросе параметра nmId/Размер ставки не изменен/т.д. | Проверьте данные запроса. Данные запроса не должны противоречить друг другу
429 | Слишком много запросов | Проверьте лимиты запросов и повторите запрос позже
5ХХ | Внутренние ошибки сервиса | Сервис недоступен. Повторите запрос позже или обратитесь в техническую поддержку

Обращайте внимание на поле `details` в ошибках `404` и `429` — туда мы добавляем полезную информацию по использованию методов

Пример ошибки:

    {
      "title": "path not found",
      "detail": "Please consult the https://dev.wildberries.ru/openapi/api-information",
      ...
      "status": 404,
      "statusText": "Not Found",
      "timestamp": "2025-04-24T07:25:28Z"
    }

## Лимиты запросов

В WB API есть ограничения на скорость отправки запросов. Для равномерного распределения нагрузки используется алгоритм `token bucket`. Лимиты для конкретных методов API указаны в документации.

Например:

Лимит запросов на один аккаунт продавца для всех методов категории Маркетплейс:

Период | Лимит | Интервал | Всплеск
--- | --- | --- | ---
1 минута | 300 запросов | 200 миллисекунд | 20 запросов

Один запрос с кодом ответа `409` учитывается как 5 запросов

- Период — временной интервал, в течение которого можно отправить максимальное количество запросов по лимиту.
- Лимит — максимальное количество запросов за период. В примере за одну минуту можно отправить до 300 запросов. Запросы должны быть равномерно распределены по времени.
- Интервал — промежуток времени для пауз между запросами. В примере должен составлять `60 секунд/300 запросов` — `200 миллисекунд` или `0.2 секунды`. Используйте интервал, чтобы равномерно распределить отправку запросов.
- Всплеск — `burst`, максимальное количество запросов, которое можно отправить одновременно, без интервальных пауз. Допустимый всплеск также возвращается в ответе в заголовке `X-Ratelimit-Remaining`. Он встречается во всех статусах ответов, кроме ошибки `429`.

`X-Ratelimit-Remaining` — это количество запросов, которое можно выполнить на данный момент без пауз. Значение `X-Ratelimit-Remaining` уменьшается на единицу после каждого запроса. Если `X-Ratelimit-Remaining` равен `0` и вы сделали следующий запрос без задержки, в ответ вы получите ошибку `429`. Значение `X-Ratelimit-Remaining` восстанавливается со временем.

Есть случаи, когда один запрос может быть равен нескольким. Например, если вы отправляете запросы категории Маркетплейс, запрос с ошибкой `409` будет равен 10 запросам с другими статусами. Тогда значение `X-Ratelimit-Remaining` снизится сразу на 10 единиц.

Если вы превысите скорость выполнения запросов, вы получите ошибку `429`. В этом случае следующий запрос вы сможете сделать только после небольшого ожидания. Чтобы понять, сколько времени вам нужно ждать, используйте заголовки ответа `429`:

- `X-Ratelimit-Retry` — через сколько секунд вы можете повторить запрос. Если вы сделаете попытку раньше, вы все равно будете получать ошибку `429`.
- `X-Ratelimit-Limit` — максимальное значение всплеска запросов — `burst`, которое будет восстановлено через `X-Ratelimit-Reset` секунд.
- `X-Ratelimit-Reset` — через сколько секунд допустимый всплеск запросов восстановится до максимального значения, указанного в `X-Ratelimit-Limit`.

Пример ответа:

    HTTP/1.1 429 Too Many Requests
    ...
    X-Ratelimit-Reset: 29
    X-Ratelimit-Retry: 2
    ...
    X-Ratelimit-Limit: 10

## Авторизация

Чтобы авторизоваться в API, вам понадобится токен. Он действует 180 дней после создания. Добавляйте токен в заголовок запроса `Authorization`.

По пункту 9.9.6 оферты запрещена интеграция с порталом продавца без WB API

## Правила использования токенов доступа к API

Подробнее о токенах можно узнать в инструкции в справочном центре

Для авторизации доступно четыре типа токенов:

Персональный токен

- Назначение: Эксклюзивный токен с расширенными возможностями. Предназначен для того, чтобы предоставлять доступ к данным продавца только вашим собственным программам — в том числе корпоративным системам (on-premise), развёрнутым на собственной или арендованной инфраструктуре.
  Расширенные возможности означают, что со временем по персональному токену появится доступ к дополнительным категориям данных продавца, которые недоступны в базовом токене. Мы заранее расскажем об этом в новостях.
- Подходит для:
  - собственных программных продуктов или систем компании, размещённых на своих или арендованных серверах
  - готовых ERP/CRM-систем в редакции on-premise, включая локальные (коробочные) версии 1С, развёрнутые на серверах компании или на компьютерах пользователей
- Ограничения: Персональный токен даёт доступ к чувствительной информации, поэтому его нельзя передавать третьим лицам или использовать в облачных сервисах. При создании токена система покажет предупреждение об ответственности — его нужно принять, чтобы продолжить.
  Настройки токена вы выбираете самостоятельно. Если не уверены, какие параметры указать, уточните у разработчика или IT-специалиста, который отвечает за подключаемую систему.

Сервисный токен

- Назначение: Специальный токен для подключения конкретного облачного сервиса из официального Каталога готовых решений для бизнеса на Wildberries.
- Особенности: При создании токена вы выбираете сервис из Каталога, после чего все необходимые настройки, в том числе категории данных и уровни доступа, заполняются автоматически. Вам останется только подтвердить создание токена и передать его сервису.
- Ограничения: Привязан к конкретному сервису и работает только с ним.

Базовый токен

- Назначение: Вспомогательный токен, который предоставляет доступ к ограниченному набору данных продавца и используется во всех случаях, когда не подходит сервисный или персональный токен.
- Подходит для:
  - тестирования интеграции на реальных данных перед запуском
  - остальных случаев, когда вы не можете использовать сервисный или персональный токен
- Ограничения: Можно работать с ограниченным набором данных.

Тестовый токен

- Назначение: Специальный токен для безопасного тестирования и отладки интеграций в изолированной среде — песочнице WB API.
- Подходит для:
  - разработки и отладки интеграций без риска для реальных данных
  - изучения возможностей API и экспериментов с методами
  - проверки новых функций перед запуском в рабочей среде
- Ограничения: Тестовый токен работает только с песочницей и даёт доступ к сгенерированным тестовым данным. Реальные данные магазина при этом недоступны. |

## Как создать персональный, базовый или тестовый токен

Подробнее о создании Сервисного токена можно узнать в инструкции в справочном центре

1. В личном кабинете перейдите в раздел Интеграции по API.
2. Нажмите + Создать токен. Откроется окно создания токена с двумя вкладками. Для всех типов токенов, кроме сервисного, выберите вкладку Для интеграции вручную.
3. Выберите тип токена.
4. Для базового и персонального токенов:

- Заполните название токена
- Выберите, с какими категориями API вы будете работать
- Задайте уровень доступа к данным: Чтение и запись или Только чтение

Категория | Методы
--- | ---
Контент | Категории, предметы и характеристики Создание карточек товаров Карточки товаров Медиафайлы Ярлыки
Аналитика | Воронка продаж Поисковые запросы по вашим товарам История остатков Аналитика продавца CSV Отчёт об остатках на складах Отчёт о товарах с обязательной маркировкой Отчёты об удержаниях Платная приёмка Платное хранение Продажи по регионам Доля бренда в продажах Скрытые товары Отчёт о возвратах и перемещении товаров
Цены и скидки | Цены и скидки Календарь акций
Маркетплейс | Заказы FBS Склады продавца Остатки Заказы DBS Самовывоз
Статистика | Основные отчёты Финансовые отчёты
Продвижение | Кампании Создание кампаний Управление кампаниями Параметры кампаний Финансы Медиа Статистика
Вопросы и отзывы | Вопросы Отзывы Закреплённые отзывы
Чат с покупателями | Чат с покупателями
Поставки | Поставки FBW
Возвраты | Возвраты покупателями
Документы | Документы
Финансы | Баланс
Пользователи | Управление пользователями продавца

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

5. Добавьте комментарий к токену по желанию. Для персонального токена отметьте чекбокс Я понимаю, что не следует передавать токен третьим лицам.
6. Нажмите Создать. Появится окно с вашим токеном.
7. Нажмите кнопку Скопировать и закрыть — окно закроется, токен будет скопирован в буфер обмена. После этого токен нельзя будет посмотреть в личном кабинете.
8. Сохраните токен в безопасном месте. Если вы потеряли токен, создайте новый.

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

## Как устроен токен

Токен представляет собой JWT согласно RFC 7519. Чтобы проверить, действителен ли ваш токен и какие категории методов API по нему доступны, вы можете декодировать его.

Рекомендуем не просматривать токен с помощью внешних онлайн-инструментов, чтобы он не попал в чужие руки

Поля токенов

Тип токена можно определить по списку полей из `payload` токена после декодирования:

Токен | Значение `acc` | Значение `for` | Значение `t`
--- | --- | --- | ---
Базовый токен | `1` | Поле отсутствует | `false`
Тестовый токен | `2` | Поле отсутствует | `true`
Персональный токен | `3` | `self` | `false`
Сервисный токен | `4` | `asid:{ID сервиса}` | `false`

Другие поля:

Поле | Тип | Описание
--- | --- | ---
id | UUIDv4 | Уникальный ID токена
s | uint | Битовая маска свойств токена
sid | UUIDv4 | Уникальный ID продавца на Wildberries, которому принадлежит токен
exp | uint | Время жизни токена. Соответствует стандарту RFC 7519: JSON Web Token (JWT)

Остальные поля `payload` служебные и могут быть удалены.

Поле `s`

Поле `s` — это битовая маска, то есть целое число, каждый бит которого означает наличие или отсутствие какого-то свойства.

Подробнее про битовую маску
Значения бит

Позиция бита отсчитывается от 0, где 0 — это младший бит.

Позиция бита | Свойство (если бит равен 1)
--- | ---
1 | Доступ к категории Контент
2 | Доступ к категории Аналитика
3 | Доступ к категории Цены и скидки
4 | Доступ к категории Маркетплейс
5 | Доступ к категории Статистика
6 | Доступ к категории Продвижение
7 | Доступ к категории Вопросы и отзывы
9 | Доступ к категории Чат с покупателями
10 | Доступ к категории Поставки
11 | Доступ к категории Возвраты покупателями
12 | Доступ к категории Документы
13 | Доступ к категории Финансы
16 | Доступ к категории Пользователи
30 | Токен только на чтение

## Декодирование токена

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

## Проверка подключения к WB API

Проверить подключение можно с токеном любой категории

## Проверка подключения{{ /ping }}

https://common-api.wildberries.ru/ping
Описание метода

Метод проверяет:

1. Успешно ли запрос доходит до WB API
2. Валидность токена авторизации и URL запроса
3. Совпадают ли категория токена и сервис

Метод не предназначен для проверки доступности сервисов WB

У каждого сервиса есть свой вариант метода в зависимости от домена:

Категория | URL запроса
--- | ---
Контент | `https://content-api.wildberries.ru/ping` `https://content-api-sandbox.wildberries.ru/ping`
Аналитика | `https://seller-analytics-api.wildberries.ru/ping`
Цены и скидки | `https://discounts-prices-api.wildberries.ru/ping` `https://discounts-prices-api-sandbox.wildberries.ru/ping`
Маркетплейс | `https://marketplace-api.wildberries.ru/ping`
Статистика | `https://statistics-api.wildberries.ru/ping` `https://statistics-api-sandbox.wildberries.ru/ping`
Продвижение | `https://advert-api.wildberries.ru/ping` `https://advert-api-sandbox.wildberries.ru/ping`
Вопросы и отзывы | `https://feedbacks-api.wildberries.ru/ping` `https://feedbacks-api-sandbox.wildberries.ru/ping`
Чат с покупателями | `https://buyer-chat-api.wildberries.ru/ping`
Поставки | `https://supplies-api.wildberries.ru/ping`
Возвраты покупателями | `https://returns-api.wildberries.ru/ping`
Документы | `https://documents-api.wildberries.ru/ping`
Финансы | `https://finance-api.wildberries.ru/ping`
Тарифы, Новости, Информация о продавце | `https://common-api.wildberries.ru/ping`
Управление пользователями продавца | `https://user-management-api.wildberries.ru/ping`

Максимум 3 запроса за 30 секунд. Если попытаться автоматизировать использование метода, запросы будут временно заблокированы. Лимит действует отдельно для каждого варианта метода в зависимости от домена

##### Authorizations:

HeaderApiKey

### Responses

### Response samples

- 200
- 401
- 429

Content type
application/json
`
{

- "TS": "2024-08-16T11:19:05+03:00",
- "Status": "OK"

}`

## API новостей

Новости портала продавцов можно получить с токеном любой категории

## Получение новостей портала продавцов{{ /api/communications/v2/news }}

https://common-api.wildberries.ru/api/communications/v2/news
Описание метода

Метод позволяет получать новости портала продавцов.
Для получения успешного ответа необходимо указать один из параметров `from` или `fromID`.
За один запрос можно получить не более 100 новостей.

Лимит запросов на один аккаунт продавца:

Период | Лимит | Интервал | Всплеск
--- | --- | --- | ---
1 минута | 1 запрос | 1 минута | 10 запросов

##### Authorizations:

HeaderApiKey

##### query Parameters

from | string <date> Example: from=2025-02-06 Дата, от которой необходимо выдать новости
fromID | integer <uint64> Example: fromID=7369 ID новости, начиная с которой — включая её — нужно получить список новостей

### Responses

### Response samples

- 200
- 401
- 429

Content type
application/json
`
{

- "data":
  [
  - {
    - "content": "Теперь в кампаниях ВБ.Медиа вы можете размещать баннеры для пользователей, которые взаимодействовали\nс товарами из определённой категории: покупали, искали, добавляли в корзину и избранное. Также можно\nвыбрать период, за который хотите учитывать эти действия.Например, вы продаёте обувь. Рекламу можно\nпоказать людям, которые добавляли в корзину или избранное товары из этой категории за последние 14\nдней. Возможно, пользователи, которые попадают под этот критерий, уже совершили покупку. Поэтому вы\nможете уточнить настройки показа: добавить параметр «Не покупал товар из категории „Обувь“ в последние\n14 дней». Так вероятность того, что ваш баннер приведёт к покупке, будет выше.Чтобы запустить рекламу,\nсоздайте в кабинете ВБ.Медиа кампанию «По показам» и на шаге 4 включите «Поведенческие параметры».\nЭти параметры можно комбинировать с таргетированием по предполагаемым интересам, полу, возрасту и\nрегиону.Подробнее о том, как настроить таргетинг, — в инструкции «По показам».Запустить рекламу на\nWildberries\n",
    - "date": "2025-02-05T14:10:35+03:00",
    - "header": "Новые настройки кампаний в ВБ.Медиа: таргетируйте рекламу в зависимости от того, как аудитория\nиспользует сервисы Wildberries\n",
    - "id": 7369,
    - "types":
      [
      - {
        - "id": 4,
        - "name": "Маркетинг"
        }
      ]
    },
  - {
    - "content": "Добавили получение отчётов по текстам поисковых запросов в формате CSV. В описания методов «Создать\nотчёт» и «Получить отчёт» добавили описания и примеры моделей: • запросов — SearchReportTextReq, •\nуспешных ответов (статус-код 200) — SearchReportTextRes.В ответ метода «Поисковые запросы по товару»\nдобавили 8 полей и структуры price и medianPosition. Узнать больше можно в Журнале изменений.Эти методы\nдоступны только с подпиской «Джем»\n",
    - "date": "2025-02-06T18:14:58+03:00",
    - "header": "Изменения в API «Аналитики и данных»",
    - "id": 7373,
    - "types":
      [
      - {
        - "id": 8,
        - "name": "API"
        },
      - {
        - "id": 41,
        - "name": "Аналитика продавца"
        }
      ]
    }
  ]

}`

## Информация о продавце

Информацию о продавце можно получить с токеном любой категории

## Получение информации о продавце{{ /api/v1/seller-info }}

https://common-api.wildberries.ru/api/v1/seller-info
Описание метода

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

Лимит запросов на один аккаунт продавца:

Период | Лимит | Интервал | Всплеск
--- | --- | --- | ---
1 минута | 1 запрос | 1 минута | 10 запросов

##### Authorizations:

HeaderApiKey

### Responses

### Response samples

- 200
- 401
- 429

Content type
application/json
`
{

- "name": "ИП Кружинин В. Р.",
- "sid": "e8923014-e233-47q8-898e-3cc86d67ea61",
- "tradeMark": "Flax Store"

}`

## Управление пользователями продавца

Для доступа к методам используйте Персональный токен для категории Пользователи

С помощью этих методов вы можете:

- Создать приглашение для пользователя с доступом к профилю продавца
- Получить список активных или приглашённых пользователей продавца
- Изменить права доступа пользователей к профилю продавца
- Закрыть доступ пользователю к профилю продавца

Управлять доступом пользователей можно только с токеном активного владельца профиля продавца.

Данная категория методов доступна только продавцам из Российской Федерации

## Создать приглашение для нового пользователя{{ /api/v1/invite }}

https://user-management-api.wildberries.ru/api/v1/invite
Описание метода

Метод создаёт приглашение для нового пользователя с настройкой доступов к разделам профиля продавца.
Как выдаются права доступа:

- Если `access` пустой (`[]`) или не указан — по умолчанию выдаются все доступы, кроме доступов к витрине (`showcase`) и Джем (`changeJam`)
- Если в `access` указана часть разделов профиля, то кроме тех доступов, что указаны в запросе, также выдаются все доступы по умолчанию
- Если в `access` перечислены все возможные разделы, доступы будут выданы согласно запросу, без доступов по умолчанию
- Если в `access` дважды указан один и тот же раздел (`code`):
  - при разных значениях `disabled` (`true` и `false`) доступ не будет выдан
  - при одинаковых значениях `"disabled": true` доступ не будет выдан
  - при одинаковых значениях `"disabled": false` доступ будет выдан

Лимит запросов на один аккаунт продавца:

Период | Лимит | Интервал | Всплеск
--- | --- | --- | ---
1 секунда | 1 запрос | 1 секунда | 5 запросов

##### Authorizations:

HeaderApiKey

##### Request Body schema: application/json
required

| Array of objects (Access) Настройки доступа к разделам профиля продавца
required | object

### Responses

### Request samples

- Payload

Content type
application/json
`
{

- "access":
  [
  - {
    - "code": "balance",
    - "disabled": false
    },
  - {
    - "code": "pointsForReviews",
    - "disabled": false
    },
  - {
    - "code": "brands",
    - "disabled": true
    },
  - {
    - "code": "finance",
    - "disabled": true
    },
  - {
    - "code": "supply",
    - "disabled": true
    }
  ],
- "invite":
  {
  - "phoneNumber": "79999999999",
  - "position": "Менеджер"
  }

}`

### Response samples

- 200
- 400
- 401
- 429

Content type
application/json
`
{

- "inviteID": "741b8aa6-08ac-4782-8a9d-d931bcbbf608",
- "expiredAt": "2025-10-06T10:56:04.335060746Z",
- "isSuccess": true,
- "inviteUrl": "https://seller.wildberries.ru/supplier-settings/supplier-card?inviteId=e5a813c7-65e0-4599-a550-a6b3d85661ed"

}`

## Получить список активных или приглашённых пользователей продавца{{ /api/v1/users }}

https://user-management-api.wildberries.ru/api/v1/users
Описание метода

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

- `isInviteOnly=true` — список приглашённых пользователей, которые ещё не активировали доступ
- `isInviteOnly=false` или не указан — список активных пользователей

По каждому пользователю можно получить:

- роль пользователя
- разделы, к которым есть доступы
- статус приглашения

Список приглашённых пользователей в ответе всегда отсортирован по дате создания: от новых до старых.

Лимит запросов на один аккаунт продавца:

Период | Лимит | Интервал | Всплеск
--- | --- | --- | ---
1 секунда | 1 запрос | 1 секунда | 5 запросов

##### Authorizations:

HeaderApiKey

##### query Parameters

limit | integer <int64> <= 100 Default: 100 Количество активных или приглашённых пользователей в ответе
offset | integer <int64> Default: 0 Сколько элементов пропустить. Например, для значения 10 ответ начнется с 11 элемента

isInviteOnly

boolean
Default: false

- `true` — список приглашённых пользователей, которые ещё не активировали доступ
- `false` или не указан — список активных пользователей профиля продавца

### Responses

### Response samples

- 200
- 400
- 401
- 429

Content type
application/json
Example
isInviteOnly=true

Список приглашённых пользователей

`
{

- "total": 2,
- "countInResponse": 2,
- "users":
  [
  - {
    - "id": 0,
    - "role": "",
    - "position": "Аналитик",
    - "phone": "79998888888",
    - "email": "",
    - "isOwner": false,
    - "firstName": "",
    - "secondName": "",
    - "patronymic": "",
    - "goodsReturn": false,
    - "isInvitee": true,
    - "inviteeInfo":
      {
      - "phoneNumber": "79998888888",
      - "position": "Аналитик",
      - "inviteUuid": "00000000-0000-4000-8000-000000000001",
      - "expiredAt": "2025-12-01T00:00:00Z",
      - "isActive": true
      },
    - "access":
      [
      - {
        - "code": "supply",
        - "disabled": true
        },
      - {
        - "code": "changeJam",
        - "disabled": true
        },
      - {
        - "code": "showcase",
        - "disabled": false
        },
      - {
        - "code": "suppliersDocuments",
        - "disabled": false
        },
      - {
        - "code": "discountPrice",
        - "disabled": true
        },
      - {
        - "code": "feedbacks",
        - "disabled": false
        },
      - {
        - "code": "questions",
        - "disabled": false
        },
      - {
        - "code": "wbPoint",
        - "disabled": false
        },
      - {
        - "code": "brands",
        - "disabled": true
        },
      - {
        - "code": "pointsForReviews",
        - "disabled": false
        },
      - {
        - "code": "pinFeedbacks",
        - "disabled": false
        },
      - {
        - "code": "finance",
        - "disabled": true
        },
      - {
        - "code": "feedbacksQuestions",
        - "disabled": false
        },
      - {
        - "code": "balance",
        - "disabled": false
        }
      ]
    },
  - {
    - "id": 0,
    - "role": "",
    - "position": "",
    - "phone": "7999XXXX102",
    - "email": "",
    - "isOwner": false,
    - "firstName": "",
    - "secondName": "",
    - "patronymic": "",
    - "goodsReturn": false,
    - "isInvitee": true,
    - "inviteeInfo":
      {
      - "phoneNumber": "79996666666",
      - "position": "Аналитик",
      - "inviteUuid": "00000000-0000-4000-8000-000000000002",
      - "expiredAt": "2025-12-10T00:00:00Z",
      - "isActive": false
      },
    - "access":
      [
      - {
        - "code": "supply",
        - "disabled": true
        },
      - {
        - "code": "changeJam",
        - "disabled": true
        },
      - {
        - "code": "showcase",
        - "disabled": false
        },
      - {
        - "code": "suppliersDocuments",
        - "disabled": false
        },
      - {
        - "code": "discountPrice",
        - "disabled": true
        },
      - {
        - "code": "feedbacks",
        - "disabled": false
        },
      - {
        - "code": "questions",
        - "disabled": false
        },
      - {
        - "code": "wbPoint",
        - "disabled": false
        },
      - {
        - "code": "brands",
        - "disabled": true
        },
      - {
        - "code": "pointsForReviews",
        - "disabled": false
        },
      - {
        - "code": "pinFeedbacks",
        - "disabled": false
        },
      - {
        - "code": "finance",
        - "disabled": true
        },
      - {
        - "code": "feedbacksQuestions",
        - "disabled": false
        },
      - {
        - "code": "balance",
        - "disabled": false
        }
      ]
    }
  ]

}`

## Изменить права доступа пользователей{{ /api/v1/users/access }}

https://user-management-api.wildberries.ru/api/v1/users/access
Описание метода

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

Лимит запросов на один аккаунт продавца:

Период | Лимит | Интервал | Всплеск
--- | --- | --- | ---
1 секунда | 1 запрос | 1 секунда | 5 запросов

##### Authorizations:

HeaderApiKey

##### Request Body schema: application/json
required

required | Array of objects (UserAccess) Настройки доступа для пользователя

### Responses

### Request samples

- Payload

Content type
application/json
`
{

- "usersAccesses":
  [
  - {
    - "userId": 42334965,
    - "access":
      [
      - {
        - "code": "balance",
        - "disabled": false
        },
      - {
        - "code": "finance",
        - "disabled": true
        },
      - {
        - "code": "feedbacks",
        - "disabled": false
        }
      ]
    },
  - {
    - "userId": 52334965,
    - "access":
      [
      - {
        - "code": "balance",
        - "disabled": true
        },
      - {
        - "code": "changeJam",
        - "disabled": false
        },
      - {
        - "code": "showcase",
        - "disabled": false
        }
      ]
    }
  ]

}`

### Response samples

- 400
- 401
- 429

Content type
application/json
`
{

- "title": "Bad Request",
- "status": 400,
- "detail": "bad request cause: user is not in current supplier",
- "requestId": "c479c04d0b576a9ba0b20fdf235004c2",
- "origin": "public-acl"

}`

## Удалить пользователя{{ /api/v1/user }}

https://user-management-api.wildberries.ru/api/v1/user
Описание метода

Метод удаляет пользователя из списка сотрудников продавца. Этому пользователю будет закрыт доступ в профиль продавца.

Лимит запросов на один аккаунт продавца:

Период | Лимит | Интервал | Всплеск
--- | --- | --- | ---
1 секунда | 1 запрос | 1 секунда | 10 запросов

##### Authorizations:

HeaderApiKey

##### query Parameters

deletedUserID required | integer <int64> ID пользователя, которому будет закрыт доступ

### Responses

### Response samples

- 400
- 401
- 429

Content type
application/json
`
{

- "title": "Bad Request",
- "status": 400,
- "detail": "bad request cause: user is not in current supplier",
- "requestId": "c479c04d0b576a9ba0b20fdf235004c2",
- "origin": "public-acl"

}`