Wildberries API: POST /content/v2/cards/update — Редактирование карточек

Карточка перезаписывается целиком — передавайте все параметры.

Параметр	Где	Тип	Обяз.	Описание
nmID	body	integer	да	Артикул WB
vendorCode	body	string	да	Артикул продавца
sizes	body	array	да	Размеры
brand	body	string	нет	Бренд
title	body	string	нет	Наименование, до 60 символов
description	body	string	нет	Описание
characteristics	body	array	нет	Характеристики

Базовые URL

• Боевой (Контент): https://content-api.wildberries.ru
• Тестовый (Контент): https://content-api-sandbox.wildberries.ru
• Боевой (Цены и скидки): https://discounts-prices-api.wildberries.ru
• Тестовый (Цены и скидки): https://discounts-prices-api-sandbox.wildberries.ru
• Боевой (Маркетплейс): https://marketplace-api.wildberries.ru
• Боевой (Статистика): https://statistics-api.wildberries.ru
• Тестовый (Статистика): https://statistics-api-sandbox.wildberries.ru
• Боевой (Аналитика): https://seller-analytics-api.wildberries.ru
• Боевой (Продвижение): https://advert-api.wildberries.ru
• Боевой (Вопросы и отзывы): https://feedbacks-api.wildberries.ru
• Боевой (Чат с покупателями): https://buyer-chat-api.wildberries.ru
• Боевой (Поставки): https://supplies-api.wildberries.ru
• Боевой (Возвраты): https://returns-api.wildberries.ru
• Боевой (Документы): https://documents-api.wildberries.ru
• Боевой (Тарифы, Новости): https://common-api.wildberries.ru

Авторизация

Тип: API-ключ

Токен создаётся в кабинете продавца: «Настройки» → «Доступ к API» → выбрать категории → «Создать токен». Сохраните его сразу — повторно посмотреть нельзя. Токен — JWT, действует 180 дней. Передаётся в заголовке Authorization.

Типы токенов: стандартный (полный доступ к выбранным категориям), тестовый (работает только в песочнице) и «только на чтение». Категория токена должна совпадать с категорией вызываемого API, иначе будет 401.

Проверить доступ можно методом /ping на хосте категории, например https://content-api.wildberries.ru/ping. Ответ:

{"TS": "...", "Status": "OK"}

Нюансы

• У каждой категории свой хост и свой токен-доступ; токен без нужной категории даёт 401.
• Лимиты работают по алгоритму token bucket: допустимы всплески, а X-Ratelimit-Remaining показывает, сколько запросов можно сделать без задержки.
• При 429 приходят заголовки X-Ratelimit-Retry (через сколько секунд повторять), X-Ratelimit-Limit (размер всплеска) и X-Ratelimit-Reset (через сколько секунд всплеск восстановится). Повтор раньше Retry снова вернёт 429.
• В категории «Маркетплейс» ответ 409 засчитывается как 5 запросов.
• Создание карточек асинхронное: успешный ответ не гарантирует создание, ошибки смотрят отдельным методом.
• Обновление карточки перезаписывает её целиком.

Сценарии с этим методом

• Создать карточку товара

---

Если этого недостаточно — официальная документация: https://dev.wildberries.ru/openapi/api-information Вся интеграция одним документом: https://mcp-everything.ru/integrations/wildberries.md