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 Request | X-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 | Операция не поддерживается |