Перейти к основному содержимому

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

POST 
/content/v2/get/cards/list

Метод доступен по токену (/openapi/api-information#tag/Avtorizaciya/Kak-sozdat-personalnyj-bazovyj-ili-testovyj-token) с категорией Контент или Продвижение

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

В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через отдельный метод (/openapi/work-with-products#tag/Kartochki-tovarov/paths/1content1v21get1cards~1trash/post)

Чтобы получить больше 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":"***"} из последнего ответа текущей выгрузки.

Лимит запросов (/openapi/api-information#tag/Vvedenie/Limity-zaprosov) на один аккаунт продавца для всех методов категории Контент:

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

Исключение — методы:

создания карточек товаров (/openapi/work-with-products#tag/Sozdanie-kartochek-tovarov/paths/1content1v21cards1upload/post) создания карточек товаров с присоединением (/openapi/work-with-products#tag/Sozdanie-kartochek-tovarov/paths/1content1v21cards1upload1add/post) редактирования карточек товаров (/openapi/work-with-products#tag/Kartochki-tovarov/paths/1content1v21cards1update/post) получения несозданных карточек товаров с ошибками (/openapi/work-with-products#tag/Kartochki-tovarov/paths/1content1v21cards1error1list/post)

Request​

Responses​

Успешно