Найти товары, подходящие для объединения (SPU)

POST /v1/product-cards/union/matching

POST/v1/product-cards/union/matching

Возвращает список товаров, которые могут быть добавлены в указанную SPU-группу (по категории, бренду, схожим атрибутам).

Тело запроса

filter
[ "object", "null" ]
Показать свойства
seller_spu_ids
[ "array", "null" ]
По SPU ID
seller_sku_ids
[ "array", "null" ]
По SKU продавца (найти объединения, содержащие эти SKU)
pagination
object
Cursor-пагинация. Первый запрос - без cursor (или пустой). Для получения следующей страницы - передать cursor из ответа (pagination.next_cursor). Если has_next: false - достигнут конец списка.
Показать свойства
cursor
[ "string", "null" ]
Курсор для следующей страницы (opaque-токен, генерируется сервером). Пусто или отсутствие - первая страница.
limit
integer
required
Лимит элементов на странице

Успешный ответ

200Список подходящих товаров
application/json
object
cards
array
required
Полные данные карточки товара (как при создании) + статусы
Показать свойства
showcase_sku_id
string
required
SKU витрины
seller_sku_id
string
required
SKU продавца
seller_default_offer_id
[ "string", "null" ]
Default offer ID продавца
showcase_default_offer_id
[ "string", "null" ]
required
Default offer витрины
seller_spu_id
[ "string", "null" ]
SPU продавца
showcase_spu_id
[ "string", "null" ]
SPU витрины
category_id
string
required
brand_id
[ "string", "null" ]
required
kind
name
string
required
slug
[ "string", "null" ]
description
[ "string", "null" ]
tags
[ "array", "null" ]
media
[ "array", "null" ]
Медиа (изображения и видео, URL-импорт)
Показать свойства
Свойства не описаны
attributes
[ "array", "null" ]
Показать свойства
Свойства не описаны
variations
[ "array", "null" ]
Вариации товара
Показать свойства
Свойства не описаны
seller_recomendation
[ "array", "null" ]
Показать свойства
Свойства не описаны
ru
wh
dimensions
Весогабариты брутто (в упаковке). Используются для логистики и складского учёта. Витрина может отобразить эти данные в карточке товара.
locales
[ "array", "null" ]
Показать свойства
Свойства не описаны
moderation_status
reject_reason
reject_comment
[ "string", "null" ]
on_sale
boolean
required
В продаже?
created_at
string
required
updated_at
string
is_in_bundle_only
boolean
Только в составе комплекта
pagination
object
required
Результат cursor-пагинации
Показать свойства
next_cursor
[ "string", "null" ]
Курсор для следующей страницы. Передать в pagination.cursor следующего запроса. Пусто (или null), если has_next: false (достигнут конец списка).
has_next
boolean
required
true - есть следующая страница; false - достигнут конец списка.
total
[ "integer", "null" ]
Общее количество элементов (опционально). Может быть неточным (приблизительная оценка на момент запроса). Не возвращается, если сервер не может оценить общее количество.
POST/v1/product-cards/union/matching
1curl https://api.omninet.ru/v1/product-cards/union/matching \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "seller_spu_ids": [7      "string"8    ],9    "seller_sku_ids": [10      "string"11    ]12  },13  "pagination": {14    "cursor": null,15    "limit": 10016  }17}'
{
  "cards": [
    {
      "showcase_sku_id": "string",
      "seller_sku_id": "string",
      "seller_default_offer_id": null,
      "showcase_default_offer_id": null,
      "seller_spu_id": null,
      "showcase_spu_id": null,
      "category_id": "string",
      "brand_id": null,
      "kind": null,
      "name": "string",
      "slug": null,
      "description": null,
      "tags": [
        "string"
      ],
      "media": [
        {
          "url": "string",
          "alt": null,
          "content_type": "string",
          "is_main": false,
          "sort_order": null
        }
      ],
      "attributes": [
        {
          "attribute_id": "string",
          "values": [
            {
              "value_id": null,
              "text": null,
              "number": null,
              "unit_code": null,
              "ref": null,
              "is_custom": false
            }
          ],
          "visible_to_customer": true
        }
      ],
      "variations": [
        {
          "seller_sku_id": "string",
          "seller_default_offer_id": null,
          "attributes": [
            {
              "attribute_id": "string",
              "values": [
                {
                  "value_id": null,
                  "text": null,
                  "number": null,
                  "unit_code": null,
                  "ref": null,
                  "is_custom": false
                }
              ],
              "visible_to_customer": true
            }
          ]
        }
      ],
      "seller_recomendation": [
        {
          "seller_sku_id": "string",
          "spu_id": null,
          "sort_order": null
        }
      ],
      "ru": null,
      "wh": null,
      "dimensions": null,
      "locales": [
        {
          "lang": "string",
          "name": null,
          "description": null,
          "attributes": [
            {
              "attribute_id": "string",
              "values": [
                {
                  "value_id": null,
                  "text": null,
                  "number": null,
                  "unit_code": null,
                  "ref": null,
                  "is_custom": false
                }
              ],
              "visible_to_customer": true
            }
          ]
        }
      ],
      "moderation_status": null,
      "reject_reason": null,
      "reject_comment": null,
      "on_sale": true,
      "created_at": "string",
      "updated_at": "string",
      "is_in_bundle_only": false
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_next": true,
    "total": null
  }
}

Список подходящих товаров