Обновление документа товара

Обновляет название и/или порядок отображения документа товара. Передавайте только те поля, которые нужно изменить — не переданные поля остаются без изменений.

Если указанный display_sequence уже занят другим документом этого товара, возвращается ошибка 409. Остальные документы автоматически не переупорядочиваются. Если нужно освободить нужный порядок, сначала измените display_sequence другого документа.

Документы архивного товара изменять нельзя — возвращается ошибка 400.

Request

PATCH

https://api.kit.yandex.net/v1/variants/{id}/attachments/{file_id}

Body

application/merge-patch+json

{
  "title": "Инструкция по установке",
  "display_sequence": 2
}

Name

Description

display_sequence

Type: integer

Новый порядок отображения. Должен быть свободен среди документов товара, иначе возвращается ошибка 409. Остальные документы автоматически не переупорядочиваются.

title

Type: string

Новое название документа. Не должно содержать символы ':' и '/'.

Example: Инструкция по установке

Responses

200 OK

Документ успешно обновлён

Body

application/json

{
  "file_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "title": "Инструкция по установке",
  "extension": "pdf",
  "display_sequence": 1
}

Name	Description
display_sequence	Type: integer Порядок отображения.
extension	Type: string Расширение файла. Example: `pdf`
file_id	Type: string<uuid> Идентификатор файла. Example: `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
title	Type: string Название документа. Example: `Инструкция по установке`

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`

409 Conflict

Конфликт данных.

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`

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

Открепление документа от товара

Список ресурсов