POST /contents

Метод позволяет загрузить контент.

Заголовки

Название Описание
Content-Type Тип контента
Content-Disposition Имя файла
Authorization Заголовок авторизации

Content-Type

Допустимые значения Content-Type:

  • application/pdf;
  • application/xml;
  • application/pkcs7-signature;
  • application/x-pkcs7-signature;
  • application/pgp-signature;
  • application/x-x509-user-cert;
  • image/png;
  • image/jpeg;
  • image/tiff.

Content-Disposition

Формат:

  Content-Disposition: attachment; filename="ИмяФайлаКонтента.РасширениеФайла"

Тело запроса

[metadata:type-binary]:- ""

В теле запроса располагаются бинарные данные контента, который необходимо загрузить. Размер контента не должен превышать 50 МБ.

При загрузке подписи в формате pem она автоматически конвертируется в der

Пример

  POST http://api.kontur.ru/realty/drive/v2/contents
  Authorization: ReestroAuth apiKey=235dc85c-f7f9-4dc0-8bbf-dad9e0185afd&portal.orgid=1748b89b-7d34-4d47-b479-b06b40ab1a30
  Content-Disposition: attachment; filename="filename.pdf"
  Content-Type: application/pdf

Ответы

201

Тело ответа

Контент загружен успешно. В теле ответа содержится описание содержимого контента ContentInfo.

Заголовки ответа

Название Описание
Location Ссылка на контент

Пример ответа

  HTTP 201
  Location: https://api.testkontur.ru/realty/v2/contents/3a8cf2b8-ee9e-47ca-9ff9-75efced2d52e
  Content-Type: Application/json
  {
    "contentId" : "3a8cf2b8-ee9e-47ca-9ff9-75efced2d52e",
    "contentType" : "pdf",
    "contentName": "filename.pdf",
    "md5": "7E0D44C48AF788657EA6F5C4C87589E8",
    "size": "2184"
  }

400

Ошибки валидации запроса. В теле ответа содержится описание ошибки Error. Для данного метода возможны следующие ошибки:

Код ошибки Описание
UndefinedContent Не удалось найти загружаемый контент
BigContentSize Загружаемый контент больше 50 мб
WrongSignature В подписи содержится более одного подписанта
WrongContentDispositionDescription Указано неправильное описание имени файла в заголовке Content-Disposition

Пример ответа

  HTTP 400
  Content-Type Application/json
  {
      "code": "validation",
      "message": "Failed to validate request",
      "target": "api",
      "errors":
      [
        {
          "code": "WrongSignature",
          "message": "Uploaded signature has more then one signer",
          "target": "DriveApi"
        }
      ]
  }

401

Ошибка авторизации: пользователь не авторизован

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации

415

В заголовке Content-Type указан тип контента, который не поддерживается для данного метода