Описание: Получить конфигурацию для инициализации веб-редактора 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
  • URL: /onlyOffice/api/editor/GetConfig/{itemId} или /onlyOffice/api/editor/GetConfig/{itemId}/{version}
  • Headers:
    • Authorization: <UserSessionToken>

📥 Параметры запроса (URL Path)

ПараметрТипОписание
itemIdGuidID элемента-файла, открываемого в редакторе
versionstringНеобязательный. Имя конкретной (исторической) версии файла. Если не указано — открывается актуальная версия в режиме редактирования (при наличии прав); если указано — открывается указанная версия только в режиме просмотра

📤 Тело ответа (Response Body)

ПолеТипОписание
documentServerApiUrlstringURL скрипта API document-сервера OnlyOffice, который нужно подключить на странице редактора
configobjectОбъект конфигурации для DocsAPI.DocEditor (согласно спецификации OnlyOffice): содержит documentType, type, width, height, document (fileType, key, title, url, permissions), editorConfig (callbackUrl, lang, mode, user, customization) и token (JWT-подпись конфигурации)
  • No labels