Привязка объектов к группе промокодов

Привязывает товары, категории или коллекции к группе промокодов. Максимальное количество объектов — 500.

В одном запросе передавайте либо товары (product_variant_ids), либо категории и коллекции (category_ids, collection_ids) — не одновременно.

Применимо только для групп с binding_mode = SELECTED_VARIANTS (товары) или SELECTED_CATEGORIES_COLLECTIONS (категории и коллекции).

Request

POST

https://api.kit.yandex.net/v1/promocode_groups/{id}/objects/add

Body

application/json
{
  "product_variant_ids": [
    "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
  ],
  "category_ids": [
    "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
  ],
  "collection_ids": [
    "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
  ]
}

Name

Description

category_ids

Type: CategoryID[]

Идентификаторы категорий.

Example
[
  "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
]

collection_ids

Type: CollectionID[]

Идентификаторы коллекций.

Example
[
  "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
]

product_variant_ids

Type: VariantID[]

Идентификаторы товаров.

Example
[
  "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
]

VariantID

Идентификатор товара.

Type: string<uuid>

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

CategoryID

Идентификатор категории.

Type: string<uuid>

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

CollectionID

Идентификатор коллекции.

Type: string<uuid>

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

Responses

204 No Content

Объекты успешно привязаны к группе промокодов.

400 Bad Request

Некорректный запрос.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

401 Unauthorized

Не авторизован.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

404 Not Found

Ресурс не найден.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000