Список карточек товаров¶
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":"***"} из последнего ответа текущей выгрузки.
Лимит запросов на один аккаунт продавца для всех методов категории Контент:
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 100 запросов | 600 мс | 5 запросов |
Исключение — методы:
- создания карточек товаров
- создания карточек товаров с присоединением
- редактирования карточек товаров
- получения несозданных карточек товаров с ошибками
- переноса карточек товаров в корзину
- восстановления карточек товаров из корзины
- получения списка рекомендаций в карточках товаров
- установки рекомендаций для товаров
Параметры¶
| Имя | Расположение | Тип | Обязательный | Описание |
|---|---|---|---|---|
| locale | query | string | нет | Язык полей ответа name, value и object: - ru — русский - en — английский - zh — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке |
Тело запроса: object
Ответ: object
Примеры вызова¶
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::content_v2_get_cards_list_post(&config, ...).await?;