• Post category:Файлы
  • Запись изменена:03.11.2022

POST api/2.0/files/@my/file

Для этой функции требуется аутентификация.

Описание
Создает новый файл в разделе «Мои документы» с названием, указанным в запросе.

Параметры
НазваниеОписаниеТипПример
title

sent in body
Название файла
Допустимые значения: файл долже DOCX, XLSX, PPTX
строковыйтекст

Замечание
В случае, если расширение для названия файла отличается от DOCX/XLSX/PPTX и относится к одному из известных текстовых форматов, электронных таблиц или презентаций, оно будет изменено на DOCX/XLSX/PPTX соответственно. Если расширение файла не задано или неизвестно, к названию файла будет добавлено расширение DOCX.

Пример
POST api/2.0/files/@my/file
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json

{
  "title": "some text"
}

Возвращает
Информация о новом файле

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

application/json

{
  "status": 0,
  "response": {
    "folderId": 12334,
    "version": 3,
    "versionGroup": 1,
    "contentLength": "12.06 KB",
    "pureContentLength": 12345,
    "fileStatus": 2,
    "viewUrl": "http:\/\/www.Р7.com\/viewfile?fileid=2221",
    "fileType": 7,
    "fileExst": ".txt",
    "comment": null,
    "id": 216359821,
    "title": "Some titile.txt",
    "access": 1,
    "shared": false,
    "rootFolderType": 2,
    "updatedBy": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "created": "2022-10-09T20:03:09.5194681Z",
    "createdBy": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "updated": "2022-10-09T20:03:09.5194681Z"
  }
}

text/xml

<result>
  <status>0</status>
  <response>
    <folderId>12334</folderId>
    <version>3</version>
    <versionGroup>1</versionGroup>
    <contentLength>12.06 KB</contentLength>
    <pureContentLength>12345</pureContentLength>
    <fileStatus>2</fileStatus>
    <viewUrl>http://www.Р7.com/viewfile?fileid=2221</viewUrl>
    <fileType>7</fileType>
    <fileExst>.txt</fileExst>
    <comment />
    <id>216359821</id>
    <title>Some titile.txt</title>
    <access>1</access>
    <shared>false</shared>
    <rootFolderType>2</rootFolderType>
    <updatedBy>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </updatedBy>
    <created>2022-10-09T20:03:09.5194681Z</created>
    <createdBy>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </createdBy>
    <updated>2022-10-09T20:03:09.5194681Z</updated>
  </response>
</result>