Описание: Получить конфигурацию для инициализации веб-редактора OnlyOffice по элементу-файлу: адрес API document-сервера, а также объект конфигурации config, который фронтенд передаёт в JS SDK OnlyOffice (DocsAPI.DocEditor). Требует права read на элемент.
Конфигурация формируется так:
documentType: word / cell / slide) определяется по расширению файла.document.permissions.edit) даются, только если у пользователя есть право upload на элемент и запрошена не конкретная (историческая) версия, а актуальная.download, print, copy, comment, review, fillForms, chat, protect, modifyContentControl, modifyFilter) определяются наличием у пользователя права upload.document.url и editorConfig.callbackUrl — это адреса методов GetDocument/ProcessCallback этого же контроллера, которые OnlyOffice Document Server будет вызывать сам.config дополнительно подписывается JWT-токеном (поле token) для проверки подлинности запроса document-сервером.🌐 HTTP-информация
GET/onlyOffice/api/editor/GetConfig/{itemId} или /onlyOffice/api/editor/GetConfig/{itemId}/{version}Authorization: <UserSessionToken>📥 Параметры запроса (URL Path)
| Параметр | Тип | Описание |
|---|---|---|
itemId | Guid | ID элемента-файла, открываемого в редакторе |
version | string | Необязательный. Имя конкретной (исторической) версии файла. Если не указано — открывается актуальная версия в режиме редактирования (при наличии прав); если указано — открывается указанная версия только в режиме просмотра |
📤 Тело ответа (Response Body)
| Поле | Тип | Описание |
|---|---|---|
documentServerApiUrl | string | URL скрипта API document-сервера OnlyOffice, который нужно подключить на странице редактора |
config | object | Объект конфигурации для DocsAPI.DocEditor (согласно спецификации OnlyOffice): содержит documentType, type, width, height, document (fileType, key, title, url, permissions), editorConfig (callbackUrl, lang, mode, user, customization) и token (JWT-подпись конфигурации) |