Запрос EditAndRedirect

Далее происходит инициализация сессии редактирования на СО-сервере (с передачей токена внешнего хранилища – в дальнейшем он будет использован для выгрузки документа при его автосохранении). Cм. Рисунок.

Вид запроса EditAndRedirect:

POST http://co-server/wopi/editor

Документация:

https://learn.microsoft.com/en-us/microsoft-365/cloud-storage-partner-program/online/discovery#edit

https://learn.microsoft.com/en-us/microsoft-365/cloud-storage-partner-program/rest/concepts#wopisrc

https://learn.microsoft.com/en-us/microsoft-365/cloud-storage-partner-program/rest/concepts#access-token

https://learn.microsoft.com/en-us/microsoft-365/cloud-storage-partner-program/rest/concepts#file-id

СО пока не использует параметр, описанный по ссылке: https://learn.microsoft.com/en-us/microsoft-365/cloud-storage-partner-program/online/discovery#transforming-the-urlsrc-parameter.

Необходимо обратить внимание на то, что идентификатор файла File ID – это уникальное и никогда не изменяемое значение.

Запрос содержит параметры, приведенные в таблице.

Параметр запроса	Тип параметра	Описание
`WOPISrc`	`query`	URI, соответствующий шаблону `http://server/<...>/wopi*/files/<fileid>`, обязательный параметр. Будет использоваться CO сервером при запросах на WOPI сервер
`lang`	`query`	Язык, обязательный параметр
`tokeninfo`	`query`	Информация о токене `access_token`, обязательный параметр
`Host`	`header`	Имя хоста, обязательный параметр

Коды ответов приведены в таблице.

Код ответа	Описание
`200`	Успешное выполнение запроса

Пример:

curl 'https://docs-wopi.devoffice.ru/wopi/editor/?WOPISrc=https%3A%2F%2Fnextcloud.devoffice.ru%2Findex.php%2Fapps%2Fwopi%2Fwopi%2Ffiles%2F1821_ochbwwy5l2a7&title=Welcome%20to%20Nextcloud%20Hub.docx&lang=ru-ru&closebutton=1&revisionhistory=1' -H 'content-type: application/x-www-form-urlencoded' -X POST --data 'access_token=SZJrv18BFeOTn0goT0s9ICzU1xl7yvqi' -vs

в ответе возвращается заголовок, содержащий также СО токен (используется CO Web Editor):

location: https://docs-wopi.devoffice.ru/edit/14654_ochbwwy5l2a7?type=document&lang=en#X-co-auth-token=uZOe2jXSX49AI4xzZRXX0NdaDF0LiiKq

В случае работы с мобильными устройствами ответ содержит заголовок openMode, который может принимать значения view/edit.

{
 "X-co-access-token": "token",
 "id": "485_ochbwwy5l2a7",
 "filename": "Welcome to Nextcloud Hub.docx",
 "server": "https://docs-wopi.devoffice.ru",
 "mediaType": "application/vnd.collabio.xodocuments.document",
 "openMode": "edit"
}

Пример:​

Пример: