ShelfUpload

Метод ShelfUpload загружает фрагмент содержимого документа на полку документов.

POST /ShelfUpload
Query Parameters:

  • nameOnShelf – имя документа на полке документов.

  • partIndex – номер загружаемого фрагмента документа. Фрагменты индексируются с 0.

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

Request Headers:
Request Body:

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

Status Codes:

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

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

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

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

Для выполнения метода текущий пользователь должен быть авторизован в Диадоке, иначе метод вернет ошибку 403 (Forbidden).

При загрузке документа укажите в параметре nameOnShelf его будущее имя на полке. Вы можете загрузить документ в локальное или публичное пространство имен полки.

Чтобы загрузить документ на полку, разделите его бинарное содержимое на части и загрузите каждую часть отдельным вызовом метода ShelfUpload.

Примечание

Размер каждой загружаемой части содержимого не должен превышать 70 Мб.

Последнюю часть документа загрузите с параметром isLastPart = 1: это сообщит серверу, что вы загрузили все части документа. В ответе метод сообщит, все ли части были загружены успешно.

Если при загрузке каких-то частей документа произошли ошибки, то метод вернет в теле ответа список номеров этих частей в формате JSON. Загрузите эти части повторно.

Если документ загружен полностью, то он становится доступным для чтения с полки документов, и его имя можно указать в поле NameOfShelf структур SignedContent и UnsignedContent.

См. также

Определение:
Другие методы для работы с полкой документов:

  • ShelfDownload — загружает данные с полки