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

Прикрепляет документ к товару по идентификатору ранее загруженного файла (файл загружается через POST /v1/files).

Ограничения:

не более 10 документов на товар;
допустимые расширения файла — pdf, doc, docx, xls, xlsx, rtf, txt, jpg, jpeg, png, svg, webp;
название не должно содержать символы ':' и '/';
к архивному товару прикрепить документ нельзя.

Возвращает 409 Conflict, если файл уже прикреплен к товару или порядок отображения занят другим документом.

Request

POST

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

application/json

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

Name	Description
file_id	Type: string<uuid> Идентификатор файла. Файл должен быть предварительно загружен с помощью запроса `POST /v1/files`. Example: `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
title	Type: string Название документа. Не должно содержать символы ':' и '/'. Example: `Инструкция по установке`
display_sequence	Type: integer Порядок отображения. Должен быть уникален среди документов товара. Если не задан — используется следующий свободный.

Документ успешно прикреплен к товару.

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: `Инструкция по установке`

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

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`

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

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`

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

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`

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

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`

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

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`