• Post category:WOPI REST API
  • Запись изменена:16.06.2023

WOPI REST API определяет набор операций, которые позволяют клиенту получать доступ и изменять файлы, хранящиеся на сервере.

Р7 Document Server использует следующие операции WOPI:

  • CheckFileInfo — возвращает информацию о свойствах файла, правах доступа и настройках редактора.
  • GetFile — запрашивает сообщение для получения файла для операции HTTP://server/<…>/wopi*/files/<id>/contents.
  • Lock — блокирует редактирование файла онлайн-офисом, запросившим блокировку.
  • RefreshLock — обновляет блокировку файла, сбрасывая его автоматический таймер истечения срока действия до 30 минут.
  • Unlock — позволяет редактировать файл.
  • PutFile — запрашивает сообщение для обновления файла для операции HTTP://server/<…>/wopi*/files/<id>/contents.
  • RenameFile -переименовывает файл.
Возможные коды ошибок и их описание
Код ошибкиописание
200 OKУспешно
400 Bad RequestX-WOPI-Lock не был предоставлен или был пуст / Указанное имя недопустимо
401 UnauthorizedНедопустимый маркер доступа
404 Not FoundРесурс не найден/пользователь не авторизован
409 ConflictБлокировка не соответствует/заблокирована другим интерфейсом; заголовок ответа X-WOPI-Lock, содержащий значение текущей блокировки файла, должен всегда включаться при использовании этого кода ответа
412 Precondition FailedРазмер файла превышает X-WOPI-MaxExpectedSize.
413 Request Entity Too LargeФайл слишком большой; максимальный размер файла зависит от хоста
500 Internal Server ErrorОшибка сервера
501 Not ImplementedОперация не поддерживается