POST /wopi/files/(file_id)
Позволяет редактировать файлы.
Эта операция работает следующим образом:
- Хост WOPI проверяет, заблокирован ли файл в данный момент или нет.
- Если файл разблокирован или если файл в данный момент заблокирован и значение X-WOPI-Lock не соответствует текущей блокировке файла, хост должен вернуть 409 Conflict («несоответствие блокировки») и включить заголовок ответа X-WOPI-Lock, содержащий значение текущей блокировки в файле. В случае, когда файл разблокирован, хост должен установить X-WOPI-Lock в пустую строку.
- В случае, когда файл заблокирован сторонним клиентом, хосты все равно должны всегда включать текущий идентификатор блокировки в заголовок ответа X-WOPI-Lock
Параметры
| Название | Описание | Тип |
| file_id | Идентификатор файла, который должен быть безопасным для URL.. | строковый |
Параметры запроса
| Название | Описание | Тип |
| access_token | Маркер доступа, который хост будет использовать для определения того, авторизован ли запрос. | строковый |
Заголовки запросов
| Название | Описание | Тип | Наличие |
| X-WOPI-Override | Запрошенная операция с сервера WOPI (UNLOCK). | строковый | обязательно |
| X-WOPI-Lock | Идентификатор блокировки, который хост должен использовать для идентификации блокировки файла. | строковый | обязательно |
Заголовки ответов
| Название | Описание | Тип | Наличие |
| X-WOPI-Lock | Идентификатор блокировки, идентифицирующий текущую блокировку файла. Этот заголовок всегда должен быть включен при ответе на запрос с 409 Conflict. Его не следует включать при ответе на запрос 200 ОК. | строковый | необязательно |
| X-WOPI-LockFailureReason | Причина неуспешной блокировки. Этот заголовок может быть включен при ответе на запрос с 409 Conflict. Он должен использоваться только для регистрационных целей. | строковый | необязательно |
| X-WOPI-ItemVersion | Версия файла. | строковый | необязательно |