Создание подарка

Создает новый подарок за покупку с товарами. Подарок создается в статусе INACTIVE.

Request

POST

https://api.kit.yandex.net/v1/gifts

Body

application/json

{
  "title": "Подарок при заказе от 1000 рублей",
  "min_cart_total": "1000.00",
  "default_sort": "POPULARITY",
  "variant_ids": [
    "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
  ]
}

Name	Description
min_cart_total	Type: string<decimal> Минимальная сумма корзины для получения подарка. Example: `1000.00`
title	Type: string Название подарка. Max length: `2000` Example: `Подарок при заказе от 1000 рублей`
variant_ids	Type: VariantID[] Идентификаторы товаров-подарков (от 1 до 50). Min items: `1` Max items: `50` Example `[ "019b21d9-c5d9-777d-80bd-d67c664bc6d9" ]`
default_sort	Type: GiftDefaultSort Сортировка товаров подарка по умолчанию: `POPULARITY` — по популярности. `CHEAPEST` — сначала дешевые. `EXPENSIVE` — сначала дорогие. `NEWEST` — сначала новые. `OLDEST` — сначала старые. Default: `POPULARITY` Enum: `POPULARITY`, `CHEAPEST`, `EXPENSIVE`, `NEWEST`, `OLDEST`

GiftDefaultSort

Сортировка товаров подарка по умолчанию:

POPULARITY — по популярности.
CHEAPEST — сначала дешевые.
EXPENSIVE — сначала дорогие.
NEWEST — сначала новые.
OLDEST — сначала старые.

Type: string

Default: POPULARITY

Enum: POPULARITY, CHEAPEST, EXPENSIVE, NEWEST, OLDEST

VariantID

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

Type: string<uuid>

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

Responses

201 Created

Подарок успешно создан.

Body

application/json

{
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "title": "Подарок при заказе от 1000 рублей",
  "min_cart_total": "1000.00",
  "status": "ACTIVE",
  "default_sort": "POPULARITY",
  "created_at": "2020-01-01T00:00:00Z",
  "updated_at": "2020-01-01T00:00:00Z"
}

Name	Description
created_at	Type: string<date-time> Дата создания подарка. Example: `2020-01-01T00:00:00Z`
default_sort	Type: GiftDefaultSort Сортировка товаров подарка по умолчанию: `POPULARITY` — по популярности. `CHEAPEST` — сначала дешевые. `EXPENSIVE` — сначала дорогие. `NEWEST` — сначала новые. `OLDEST` — сначала старые. Default: `POPULARITY` Enum: `POPULARITY`, `CHEAPEST`, `EXPENSIVE`, `NEWEST`, `OLDEST`
id	Type: GiftID Идентификатор подарка. Example: `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
min_cart_total	Type: string<decimal> Минимальная сумма корзины для получения подарка. Example: `1000.00`
status	Type: GiftStatus Статус подарка: `ACTIVE` — активный подарок (доступен покупателям). `INACTIVE` — неактивный подарок. Enum: `ACTIVE`, `INACTIVE`
title	Type: string Название подарка. Example: `Подарок при заказе от 1000 рублей`
updated_at	Type: string<date-time> Дата последнего обновления подарка. Example: `2020-01-01T00:00:00Z`

GiftID

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

Type: string<uuid>

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

GiftStatus

Статус подарка:

ACTIVE — активный подарок (доступен покупателям).
INACTIVE — неактивный подарок.

Type: string

Enum: ACTIVE, INACTIVE

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`

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`

Была ли статья полезна?

Получение списка подарков

Получение подарка по ID