PUT api/2.0/files/file/{fileId}/share
Для этой функции требуется аутентификация
Описание
Устанавливает настройки общего доступа к файлу с идентификатором, указанным в запросе.
Параметры
| Название | Описание | Тип | Пример |
| fileId
sent in url
|
Идентификатор файла | строковый | текст |
| share
sent in body
|
Набор параметров совместного использования | Collection of FileShareParamss
collection
|
share[0].ShareTo=9924256A-739C-462b-AF15-E652A3B1B6EB&share[0].Access=0 |
| notify
sent in body
|
Уведомляет пользователей об общем файле | логический | true |
| sharingMessage
sent in body
|
Сообщение для отправки при уведомлении об общем файле | строковый | текст |
Примечание
Каждый из параметров «поделиться» должен содержать два значения: «ShareTo» — идентификатор пользователя, с которым мы хотим поделиться файлом, и «Access» — тип доступа, который мы хотим предоставить пользователю (Read, ReadWrite и т. д.)
Каждый из параметров «поделиться» должен содержать два значения: «ShareTo» — идентификатор пользователя, с которым мы хотим поделиться файлом, и «Access» — тип доступа, который мы хотим предоставить пользователю (Read, ReadWrite и т. д.)
Пример
PUT api/2.0/files/file/some+text/share
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
"share": [
{
"shareTo": "00000000-0000-0000-0000-000000000000",
"access": 0
}
],
"notify": true,
"sharingMessage": "some text"
}
Возвращает
Информация об общем файле
Пример ответа
application/json
{
"status": 0,
"response": [
{
"access": 1,
"sharedTo": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"isLocked": false,
"isOwner": true
}
]
}
text/xml
<result>
<status>0</status>
<response>
<access>1</access>
<sharedTo>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</sharedTo>
<isLocked>false</isLocked>
<isOwner>true</isOwner>
</response>
</result>