Метод POST /content/v2/get/cards/list представляет собой мощный инструмент API на платформе Wildberries, предназначенный для получения списка созданных номенклатур (НМ) с возможностью фильтрации, пагинации и сортировки. Этот метод позволяет продавцам эффективно управлять своим ассортиментом, получая актуальную информацию о товарах в каталоге.
Ключевые особенности
Фильтрация: Метод поддерживает различные параметры фильтрации, позволяющие уточнить запросы для получения конкретных данных о номенклатурах, например, товары с фотографиями или без.
Пагинация: Для обработки больших объемов данных (более 1000 номенклатур) используется механизм пагинации. Это позволяет эффективно загружать списки товаров порциями, упрощая обработку данных и снижая нагрузку на систему.
Сортировка: Метод предоставляет возможность сортировки полученного списка номенклатур, что облегчает анализ и управление товарными позициями.
Пример использования метода
Шаг 1: Первоначальный запрос
Для начала работы с методом необходимо сформировать первоначальный запрос, указав обязательные параметры. Например:
POST https://suppliers-api.wildberries.ru/content/v2/get/cards/list
Authorization: HeaderApiKey <Ваш API-ключ>
Content-Type: application/json
{
"settings": {
"cursor": {
"limit": 1000
},
"filter": {
"withPhoto": -1
}
}
}
Этот запрос инициирует получение списка номенклатур с использованием пагинации и фильтрации по наличию фотографий.
Шаг 2: Использование пагинации
После получения ответа необходимо проверить поле cursor в конце списка для определения параметров следующего запроса. Копируйте значения updatedAt и nmID из cursor и вставьте их в новый запрос для продолжения получения списка:
{
"settings": {
"cursor": {
"limit": 1000,
"updatedAt": "дата обновления",
"nmID": идентификатор номенклатуры
},
"filter": {
"withPhoto": -1
}
}
}
Повторяйте этот процесс, пока значение total в ответе не станет меньше указанного в limit, что означает получение всех доступных карточек.
Важные замечания
Карточки, находящиеся в корзине, не включаются в ответ и требуют использования отдельного метода для получения.
Метод поддерживает настройку языка ответа через параметр locale, что позволяет адаптировать информацию для международных продавцов.
Заключение
Использование метода POST /content/v2/get/cards/list на Wildberries позволяет продавцам глубоко анализировать и управлять своими номенклатурами, оптимизируя процесс работы с ассортиментом и улучшая предложения для покупателей. Эффективное применение фильтрации, пагинации и сортировки способствует более точному позиционированию товаров на рынке.