Обновление подарка

Обновляет подарок. Передаются только изменяемые поля.

Request

PATCH

https://api.kit.yandex.net/v1/gifts/{id}

Body

application/json

{
  "title": "Подарок при заказе от 1000 рублей",
  "min_cart_total": "1000.00",
  "status": "ACTIVE",
  "default_sort": "POPULARITY"
}

Name	Description
default_sort	Type: GiftDefaultSort Сортировка товаров подарка по умолчанию: `POPULARITY` — по популярности. `CHEAPEST` — сначала дешевые. `EXPENSIVE` — сначала дорогие. `NEWEST` — сначала новые. `OLDEST` — сначала старые. Default: `POPULARITY` Enum: `POPULARITY`, `CHEAPEST`, `EXPENSIVE`, `NEWEST`, `OLDEST`
min_cart_total	Type: string<decimal> Минимальная сумма корзины для получения подарка. Example: `1000.00`
status	Type: GiftStatus Статус подарка: `ACTIVE` — активный подарок (доступен покупателям). `INACTIVE` — неактивный подарок. Enum: `ACTIVE`, `INACTIVE`
title	Type: string Название подарка. Max length: `2000` Example: `Подарок при заказе от 1000 рублей`

GiftStatus

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

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

Type: string

Enum: ACTIVE, INACTIVE

GiftDefaultSort

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

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

Type: string

Default: POPULARITY

Enum: POPULARITY, CHEAPEST, EXPENSIVE, NEWEST, OLDEST

Responses

200 OK

Подарок успешно обновлен.

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

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`

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

Удаление подарка

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