-
Часто задаваемые вопросы сервиса документа:
Совместное редактирования - Как проверить, сколько подключений мне нужно?
Минимальное количество подключений, которое вам может понадобиться, должно быть равно количеству пользователей, которые будут использовать ваш Сервер документов. Но следует иметь в виду, что в большинстве случаев один пользователь = одно подключение, так как один и тот же пользователь может открыть более одного документа в более чем одном браузере.Поэтому, если вы уверены, что все ваши пользователи будут пользоваться Сервером документов одновременно, имейте излишек на номер подключения, равный как минимум двукратному вашему номеру пользователя, иначе пользователи с недостатком подключений будут иметь возможность открывать документ в режиме только для просмотра.Все доступные тарифные планы на подключение доступны на этой странице ↗.
- Вы можете использовать API для отправки запроса POST в командный сервис документов ↗. Используйте для этого параметр c со значением info ↗ и ключевым параметром, идентифицирующим документ, информацию о котором вы хотите найти. Параметры отправляются как часть объекта JSON в теле запроса:
{ "c": "info", "key": "Khirz6zTPdfd7" }В случае, если документ редактируется, например, двумя пользователями, служба редактирования документа сообщит службе хранения документов с помощью обработчика обратного вызова ↗ следующую информацию:
{ "key": "Khirz6zTPdfd7", "status": 1, "users": ["6d5a81d0", "78e1e841"] }- ключ — идентификатор документа (тот же, что и в POST-запросе выше);
- статус со значением 1 означает, что документ в данный момент редактируется;
- а пользователи — массив идентификаторов пользователей, принимающих участие в совместном редактировании.
Дополнительную информацию об ответе службы редактирования документов можно найти на этой странице ↗.
- Чтобы принудительно отключить пользователей от документа до его сохранения, используйте API для отправки запроса POST в командный сервис документов ↗. Используйте для этого параметр c со значением drop ↗ и ключевым параметром, идентифицирующим документ и массив идентификаторов пользователей, которых вы хотите отключить. Параметры отправляются как часть объекта JSON в теле запроса:
{ "c": "drop", "key": "Khirz6zTPdfd7", "users": [ "6d5a81d0", "78e1e841" ] }В результате два пользователя с идентификаторами в запросе выше («6d5a81d0» и «78e1e841») будут отключены от редактирования документа с ключом Khirz6zTPdfd7.
Дополнительную информацию об использовании запросов от командного сервиса документов ↗ можно найти на этой странице ↗.