ShelfUploadPart

Загружает фрагмент содержимого документа на полку документов, если первая его часть уже была загружена методом ShelfUploadPartInit.

Размер одного фрагмента должен быть не больше 512 KB, а размер всего загружаемого документа — до 400 MB.

Подробнее про загрузку документов на полку в разделе Работа с полкой документов.

POST /ShelfUploadPart
Query Parameters:

  • fileName – имя документа на полке документов, сгенерированное методом ShelfUploadPartInit. Обязательный параметр.

  • partIndex – номер загружаемого фрагмента документа. Фрагменты индексируются с 0, при этом нулевой фрагмент был загружен методом ShelfUploadPartInit: поэтому при первом вызове метода ShelfUploadPart передайте параметр partIndex = 1, а при каждом следующем вызове увеличивайте на 1.

  • isLastPart – признак того, что загружается последний фрагмент документа. Для последнего фрагмента должен быть равен true, для остальных может отсутствовать или быть равным false. По умолчанию имеет значение false.

Request Headers:
Request Body:

Тело запроса должно содержать бинарные данные документа, представляющие собой фрагмент содержимого. Максимальный размер одного фрагмента — 512 KB.

Status Codes:

  • 200 OK – операция успешно завершена.

  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

  • 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.

  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит массив с индексами фрагментов файла fileName, которые не удалось успешно загрузить на полку. В случае успешной загрузки вернется пустой массив.

Примеры использования

Пример HTTP-запроса:

POST /ShelfUploadPart?fileName=dd-api-99048eaf-0635-4035-986a-add1c0089c3f&partIndex=1&isLastPart=true HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: text/plain; charset=utf-8

См. также

Методы для работы с полкой документов:

  • ShelfDownload (V2) — загружает содержимое документа с полки документов

  • ShelfUpload (V2) — загружает содержимое документа на полку документов целиком

  • ShelfUploadPart — загружает фрагмент содержимого документа на полку документов, если первая его часть уже была загружена методом ShelfUploadPartInit

  • ShelfUploadPartInit — загружает первый фрагмент документа на полку документов