POST api/2.0/files/{folderId}/file
Для этой функции требуется аутентификация.
Описание
Создает новый файл в указанной папке с заголовком, указанным в запросе.
Параметры
| Название | Описание | Тип | Пример |
| folderId
sent in url
|
Идентификатор папки | строковый | текст |
| title
sent in body
|
Название файла
Допустимые значения: файл должен иметь одно из следующих расширений: DOCX, XLSX, PPTX |
строковый | текст |
| templateId
sent in body
|
Идентификатор шаблона файлв | строковый | текст |
| enableExternalExt
sent in body
|
Возможность создавать файлы любого расширения | логический | true |
Примечание
В случае, если расширение для названия файла отличается от DOCX/XLSX/PPTX и относится к одному из известных текстовых форматов, электронных таблиц или презентаций, оно будет изменено на DOCX/XLSX/PPTX соответственно. Если расширение файла не задано или неизвестно, к названию файла будет добавлено расширение DOCX.
Пример
POST api/2.0/files/some+text/file
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
"title": "some text",
"templateId": "some text",
"enableExternalExt": true
}
Возвращает
Информация о новом файле
Пример ответа
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>