Skip to main content

Инициализация сессии просмотра, запрос ViewAndRedirect

По нажатию на открытие файла в интерфейсе файлового хранилища происходит инициализация сессии редактирования на СО-сервере (запрос **ViewAndRedirect,**cм. Рисунок). В discovery это может быть прописано как:

<action name="view" default="true" ext="potx" urlsrc="https://docs-dora.devoffice.ru/wopi/viewer/?"/>

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

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

ViewAndRedirect​

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

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

Параметр запросаТип параметраОписание
WOPISrcqueryURI, соответствующий шаблону http://server/<...>/wopi*/files/<fileid>, обязательный параметр
langqueryКодировка, обязательный параметр
tokeninfoqueryИнформация о токене access_token, обязательный параметр
HostheaderИмя хоста, обязательный параметр

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

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

Пример:​

curl -X POST 'https://docs-wopi.devoffice.ru/wopi/viewer/?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' --data 'access_token=SZJrv18BFeOTn0goT0s9ICzU1xl7yvqi&access_token_ttl=1637965708000' -vs

В случае работы с мобильными устройствами ответ содержит заголовок 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": "view"
}