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

http

POST /content/v2/get/cards/trash

База: https://content-api.wildberries.ru · Модуль: items · Раздел: Карточки товаров · Документация спецификации ↗

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

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

Сделайте первый запрос:

        {
          "settings": {
            "sort": {
              "ascending": true
            },
            "cursor": {
              "limit": 100
            }
          }
        }

Чтобы получать только карточки товаров, которые были перенесены в корзину после выгрузки, используйте сортировку по возрастанию: "sort":{"ascending":true}. 2. Скопируйте "trashedAt":"\*\*\*","nmID":\*\*\* из cursor ответа и вставьте в cursor запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение total в ответе не станет меньше, чем значение limit в запросе. Это будет означать, что вы получили все карточки. Чтобы получать только карточки товаров, которые были перенесены в корзину после предыдущей выгрузки данных:

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

Лимит запросов на один профиль продавца для всех методов категории Контент:

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

В песочнице — максимум 1 запрос в секунду суммарно для всех методов Контента.

Параметры

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

Тело запроса

application/json — схема object, обязательно

settings object — Настройки
- sort object — Сортировка по дате и времени помещения карточек товаров в корзину trashedAt
  - ascending boolean — Порядок сортировки: - false — по убыванию - true — по возрастанию
- cursor object — Пагинатор
  - limit integer<int64> — Сколько карточек товаров выдать в ответе
  - trashedAt string — Дата и время помещения в корзину
  - nmID integer<int64> — Артикул WB, с которого надо запрашивать следующий список карточек товаров
- filter object — Параметры фильтрации
  - textSearch string — Поиск по артикулу продавца, артикулу WB, баркоду

Ответы

Код	Описание	Схема
`200`	Успешно	`PostV2GetCardsTrashResponse200`
`400`	Неправильный запрос	`responseBodyContentError400`
`401`	Не авторизован	`object`
`402`	Требуется платёж	`object`
`403`	Доступ запрещён	`responseBodyContentError403`
`429`	Слишком много запросов	`object`

Структура 200:

cards object[] — Массив карточек товаров
- nmID integer<int64> — Артикул WB
- vendorCode string — Артикул продавца
- kizMarked boolean — Подтверждение, что на товар нанесён обязательный код маркировки Честного знака: - true — продавец подтверждает, что на товар нанесён обязательный код маркировки. - false — продавец не подтверждает, что на товар нанесён обязательный код маркировки. Передайте в запросе true, чтобы подтвердить наличие обязательного кода маркировки на товаре. Карточка товара не пройдёт проверку, если от продавца нет подтверждения о том, что на товар нанесён обязательный код маркировки. Чтобы проверить, является ли код маркировки Честного знака обязательным, используйте метод Список карточек товаров, поле ответа needKiz
- subjectID integer<int64> — ID предмета
- subjectName string — Название предмета
- photos object[] — Массив фото
  - big string — URL фото 900x1200
  - c246x328 string — URL фото 248x328
  - c516x688 string — URL фото 516x688
  - square string — URL фото 600x600
  - tm string — URL фото 75x100
- video string — URL видео
- wholesale object — B2B-продажа
  - enabled boolean — Предназначен ли товар для продажи только B2B-покупателям: - true — товар предназначен для продажи только B2B-покупателям - false — товар предназначен для продажи B2B и B2C-покупателям
  - quantum number<uint64> — Минимальное количество единиц товара в одной корзине B2B-покупателя. Только при "enable":true
- sizes object[] — Массив размеров
  - chrtID integer<int64> — ID размера
  - techSize string — Размер товара
  - wbSize string — Российский размер товара
  - skus string[] — Массив баркодов
- dimensions object — Габариты и вес товара c упаковкой, см и кг
  - length integer<int64> — Длина, см
  - width integer<int64> — Ширина, см
  - height integer<int64> — Высота, см
  - weightBrutto number — Вес, кг Количество знаков после запятой <=3
  - isValid boolean — Потенциальная некорректность габаритов товара: - true — не выявлена. "isValid":true не гарантирует, что размеры указаны корректно. В отдельных случаях (например, при создании новой категории товаров) "isValid":true будет возвращаться при любых значениях, кроме нулевых. - false — указанные габариты значительно отличаются от средних по категории (предмету). Рекомендуется перепроверить, правильно ли указаны размеры товара в упаковке в сантиметрах. Функциональность карточки товара, в том числе начисление логистики и хранения, при этом ограничена не будет. Логистика и хранение продолжают начисляться — по текущим габаритам. Также "isValid":false возвращается при отсутствии значений или нулевом значении любой стороны.
- characteristics object[] — Характеристики
  - id integer<int64> — ID характеристики
  - name string — Название характеристики
  - value object — Значение характеристики. Тип значения зависит от типа характеристики
- createdAt string — Date and time the item was listed
- trashedAt string — Дата и время помещения в корзину
cursor object — Пагинатор
- trashedAt string — Дата и время, с которых надо запрашивать следующий список карточек товаров
- nmID integer<int64> — Артикул WB, с которого надо запрашивать следующий список карточек товаров
- total integer<int64> — Количество возвращённых карточек товаров

Структура 400:

data object — Данные ошибки
error boolean — Флаг ошибки
errorText string — Описание ошибки
additionalErrors object — Дополнительные ошибки

Структура 401:

title string — Заголовок ошибки
detail string — Детали ошибки
code string — Внутренний код ошибки
requestId string — Уникальный ID запроса
origin string — ID внутреннего сервиса WB
status number — HTTP статус-код
statusText string — Расшифровка HTTP статус-кода
timestamp string — Дата и время запроса

Структура 402:

title string — Заголовок ошибки
detail string — Детали ошибки. Ошибка возвращается только сервисам из Каталога решений для бизнеса

Структура 403:

data object — Данные ошибки
error boolean — Флаг ошибки
errorText string — Описание ошибки
additionalErrors string — Дополнительные ошибки

Структура 429:

title string — Заголовок ошибки
detail string — Детали ошибки
code string — Внутренний код ошибки
requestId string — Уникальный ID запроса
origin string — ID внутреннего сервиса WB
status number — HTTP статус-код
statusText string — Расшифровка HTTP статус-кода
timestamp string — Дата и время запроса

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

Аргументы показаны именами параметров — подставьте свои значения. Языки, в клиенте которых этой операции нет, не показаны.

python

from wb_api_client.items import Configuration, ApiClient
from wb_api_client.items.api import ItemsApi

cfg = Configuration(access_token="<ваш JWT WB>")
api = ItemsApi(ApiClient(cfg))

result = api.post_v2_get_cards_trash(post_v2_get_cards_trash_request=..., locale=...)
print(result)

import {
  Configuration,
  ItemsApi,
} from "@valeryverkhoturov/wb-api-client/items";

const cfg = new Configuration({});
cfg.setAccessToken("<ваш JWT WB>");
const api = new ItemsApi(cfg);

const { data } = await api.postV2GetCardsTrash(postV2GetCardsTrashRequest, locale);
console.log(data);

import (
	"context"
	"fmt"

	wbitems "github.com/ValeryVerkhoturov/wb-api-client-go/items"
)

cfg := wbitems.NewConfiguration()
cfg.SetAccessToken("<ваш JWT WB>")
client := wbitems.NewAPIClient(cfg)

result, _, err := client.ItemsAPI.PostV2GetCardsTrash(context.Background()).PostV2GetCardsTrashRequest(postV2GetCardsTrashRequest).Locale(locale).Execute()
if err != nil {
    panic(err)
}
fmt.Printf("%+v\n", result)

java

import io.github.valeryverkhoturov.wbapi.items.ApiClient;
import io.github.valeryverkhoturov.wbapi.items.SecretString;
import io.github.valeryverkhoturov.wbapi.items.api.ItemsApi;

ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<ваш JWT WB>"));
ItemsApi api = new ItemsApi(client);

System.out.println(api.postV2GetCardsTrash(postV2GetCardsTrashRequest, locale));

php

use ValeryVerkhoturov\WbApiClient\Items\Configuration;
use ValeryVerkhoturov\WbApiClient\Items\SecretString;
use ValeryVerkhoturov\WbApiClient\Items\Api\ItemsApi;
use GuzzleHttp\Client;

$config = (new Configuration())
    ->setAccessTokenSecret(new SecretString('<ваш JWT WB>'));
$api = new ItemsApi(new Client(), $config);

print_r($api->postV2GetCardsTrash($post_v2_get_cards_trash_request));

bsl

#Использовать "wb-api-client"

Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<ваш JWT WB>");
Клиент = Новый ItemsApi(Настройки);

Сообщить(Клиент.PostV2GetCardsTrash(Тело).Тело);

csharp

using ValeryVerkhoturov.WbApiClient.Items.Api;
using ValeryVerkhoturov.WbApiClient.Items.Client;

var config = new Configuration();
config.AccessTokenSecret = new SecretString("<ваш JWT WB>");
var api = new ItemsApi(config);

Console.WriteLine(api.PostV2GetCardsTrash(postV2GetCardsTrashRequest));

rust

use wb_api_client::items::apis::{configuration::Configuration, items_api};

#[tokio::main]
async fn main() {
    let mut cfg = Configuration::new();
    cfg.set_access_token("<ваш JWT WB>");

    let result = items_api::post_v2_get_cards_trash(&cfg, post_v2_get_cards_trash_request, locale).await;
    println!("{:#?}", result);
}

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

Параметры ​

Тело запроса ​

Ответы ​

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

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

Параметры

Тело запроса

Ответы

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