Перейти к содержанию

Список карточек товаров

POST /content/v2/get/cards/list

Метод возвращает список созданных карточек товаров.

В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через отдельный метод

Чтобы получить больше 100 карточек товаров, используйте пагинацию: 1. Сделайте первый запрос: 

        {
          "settings": {
            "sort": {
              "ascending": true
            },
            "cursor": {
              "limit": 100
            },
            "filter": {
              "withPhoto": -1
            }
          }
        }
Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: "sort":{"ascending":true}. 2. Скопируйте "updatedAt":"***","nmID":"***" из cursor ответа и вставьте в cursor запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение total в ответе не станет меньше, чем значение limit в запросе. Это будет означать, что вы получили все карточки.

Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля "cursor":{"updatedAt":"***","nmID":"***"} из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: "sort":{"ascending":true}. 2. Укажите в первом запросе сохранённые поля "cursor":{"updatedAt":"***","nmID":"***"}. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля "cursor":{"updatedAt":"***","nmID":"***"} из последнего ответа текущей выгрузки.



В объекте documents метод возвращает: - информацию о переданных документах — массив items - результаты проверки по каждому документу — объект verdict в items. Если verdict не возвращается в ответе — проверка документа ещё не завершена - результат проверки всей карточки — объект overallVerdict. Проверка всей карточки включает проверку не только документов, но и других данных. Например, наличия обязательной маркировки и сведений из внешних реестров. Если overallVerdict не возвращается в ответе — проверка карточки ещё не завершена

Проверки документов и карточки выполняются асинхронно и могут занимать до 3 дней. Каждое изменение результата проверки обновляет дату и время изменения карточки в поле ответа updatedAt.
Чтобы получить новые результаты проверки, используйте выгрузку с пагинацией с сортировкой по возрастанию.

Лимит запросов на один профиль продавца:

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

Параметры

Имя Расположение Тип Обязательный Описание
locale query string нет Язык полей ответа name, value и object: - ru — русский - en — английский - zh — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке

Тело запроса: object

Ответ: object

Примеры вызова

import os
from wildberries_sdk import items

token = os.getenv("WB_API_TOKEN")
api = items.DefaultApi(
    items.ApiClient(items.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.post_v2_get_cards_list(object=...)
print(result)

import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.postV2GetCardsList({ ... });
console.log(result);

cfg := items.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := items.NewAPIClient(cfg)
result, _, err := client.DefaultApi.PostV2GetCardsList(context.Background()).Execute()

<?php
$config = Wildberries\Sdk\Items\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Items\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->postV2GetCardsList(...);

use wildberries_sdk_items::apis::{configuration::Configuration, configuration::ApiKey, default_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = default_api::post_v2_get_cards_list(&config, ...).await?;