POST /wopi/files/(file_id)/contents
Запрашивает сообщение об обновлении файла для HTTP://server /<…>/wopi*/файлы/<идентификатор>/операция с содержимым.
Тело запроса должно содержать полное содержимое файла в двоичном формате.
Эта операция работает следующим образом:
- Хост WOPI проверяет, заблокирован ли файл в данный момент или нет.
- Если файл в настоящее время заблокирован и значение X-WOPI-Lock не соответствует текущей блокировке файла, хост должен вернуть 409 Conflict («несоответствие блокировки») и включить заголовок ответа X-WOPI-Lock, содержащий значение текущая блокировка файла. В случае, когда файл разблокирован, хост должен установить X-WOPI-Lock на пустую строку.
- Если файл разблокирован, хост должен проверить текущий размер файла. Если это 0 байт, запрос PutFile следует считать действительным и следует продолжить. Если это любое значение, отличное от 0 байт, или вообще отсутствует, хост должен ответить 409 Conflict.
- В случае, когда файл заблокирован сторонним клиентом, хосты должны всегда включать текущий идентификатор блокировки в заголовок ответа X-WOPI-Lock.
Параметры
| Название | Описание | Тип |
| file_id | Идентификатор файла, который должен быть безопасным для URL. | строковый |
Параметры запроса
| Название | Описание | Тип |
| access_token | Маркер доступа, который хост будет использовать для определения того, авторизован ли запрос. | строковый |
Заголовки запросов
| Название | Описание | Тип | Наличие |
| X-WOPI-Override | Запрошенная операция с сервера WOPI (PUT) | строковый | обязательно |
| X-WOPI-Lock | Идентификатор блокировки, который хост должен использовать для идентификации блокировки файла. | строковый | необязательно |
| X-WOPI-Editors | Все пользователи, внесшие изменения в документ в этом запросе PutFile (значения UserId разделены запятыми). | строковый | необязательно |
| X-LOOL-WOPI-IsModifiedByUser | Указывает, изменил ли пользователь документ перед сохранением («true«) или просто нажал кнопку «Сохранить» без каких-либо изменений («false«). | строковый | необязательно |
| X-LOOL-WOPI-IsAutosave | Указывает, запускается ли PutFile автосохранением («true«) или явной операцией пользователя (кнопка «Сохранить» или пункт меню) («false«). | строковый | необязательно |
| X-LOOL-WOPI-IsExitSave | Указывает, будет ли запускаться автоматическое сохранение при очистке документа из памяти (например, при отключении всех пользователей) («true«) или нет («false«). | строковый | необязательно |
Заголовки ответов
| Название | Описание | Тип | Наличие |
| X-WOPI-Lock | Идентификатор блокировки, идентифицирующий текущую блокировку файла. Этот заголовок всегда должен быть включен при ответе на запрос с 409 Conflict. Его не следует включать при ответе на запрос 200 ОК. | строковый | необязательно |
| X-WOPI-LockFailureReason | Причина неудачной блокировки. Этот заголовок может быть включен при ответе на запрос с 409 Conflict. Он должен использоваться только для регистрационных целей. | строковый | необязательно |
| X-WOPI-ItemVersion | Версия файла. | строковый | необязательно |