При выполнении запросов в браузере со стороны клиента к Серверу документов Р7 необходимо добавить токен к параметрам для ратифицирования данных.
Открытие файла
Когда файл открывается для редактирования в Р7 Document Server, token должен быть добавлен в конфигурацию для ратифицирования параметров.
Полезная нагрузка для токена JWT в формате JSON должна иметь ту же структуру, что и конфигурацию.
Начиная с версии 7.1 список подписываемых параметров будет строго регламентирован.
Не забудьте добавить в свою подпись все параметры, перечисленные ниже:
{
"document": {
"key": "Khirz6zTPdfd7",
"permissions": {
"comment": true,
"commentGroups": {
"edit": ["Group2", ""],
"remove": [""],
"view": ""
},
"copy": true,
"deleteCommentAuthorOnly": false,
"download": true,
"edit": true,
"editCommentAuthorOnly": false,
"fillForms": true,
"modifyContentControl": true,
"modifyFilter": true,
"print": true,
"review": true,
"reviewGroups": ["Group1", "Group2", ""]
},
"url": "https://example.com/url-to-example-document.docx"
},
"editorConfig": {
"callbackUrl": "https://example.com/url-to-callback.ashx",
"mode": "edit",
"user": {
"group": "Group1",
"id": "78e1e841",
"name": "Smith"
}
}
}
Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов.
Дополнительные сведения о взаимодействии клиент-сервер службы Сервера документов см. в разделе как это работает.
Образец токена:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkb2N1bWVudCI6eyJrZXkiOiJLaGlyejZ6VFBkZmQ3IiwicGVybWlzc2lvbnMiOnsiY29tbWVudCI6dHJ1ZSwiY29tbWVudEdyb3VwcyI6eyJlZGl0IjpbIkdyb3VwMiIsIiJdLCJyZW1vdmUiOlsiIl0sInZpZXciOiIifSwiY29weSI6dHJ1ZSwiZGVsZXRlQ29tbWVudEF1dGhvck9ubHkiOmZhbHNlLCJkb3dubG9hZCI6dHJ1ZSwiZWRpdCI6dHJ1ZSwiZWRpdENvbW1lbnRBdXRob3JPbmx5IjpmYWxzZSwiZmlsbEZvcm1zIjp0cnVlLCJtb2RpZnlDb250ZW50Q29udHJvbCI6dHJ1ZSwibW9kaWZ5RmlsdGVyIjp0cnVlLCJwcmludCI6dHJ1ZSwicmV2aWV3Ijp0cnVlLCJyZXZpZXdHcm91cHMiOlsiR3JvdXAxIiwiR3JvdXAyIiwiIl19LCJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL3VybC10by1leGFtcGxlLWRvY3VtZW50LmRvY3gifSwiZWRpdG9yQ29uZmlnIjp7ImNhbGxiYWNrVXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tY2FsbGJhY2suYXNoeCIsIm1vZGUiOiJlZGl0IiwidXNlciI6eyJncm91cCI6Ikdyb3VwMSIsImlkIjoiNzhlMWU4NDEiLCJuYW1lIjoiU21pdGgifX19.irYst9vmsLoQtC-95A-6W8DnbqGXCbmcxJajfbPh6tQ
Методы
insertImage
При вызове метода insertImage для вставки изображения в файл необходимо добавить token для ратифицирования параметров.
Полезная нагрузка для токена JWT в формате JSON должна иметь ту же структуру, что и параметр метода.
Список параметров для подписи строго не регламентирован, но мы рекомендуем указывать все отправляемые параметры:
{
"fileType": "png",
"url": "https://example.com/url-to-example-image.png"
}
Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов.
Дополнительные сведения о взаимодействии клиент-сервер службы Сервера документов см. в разделе как это работает.
Образец токена:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6InBuZyIsInVybCI6Imh0dHBzOi8vZXhhbXBsZS5jb20vdXJsLXRvLWV4YW1wbGUtaW1hZ2UucG5nIn0.FXuC3GUvPq3japwyzo4i-utUe3g1rfSDt1ytuK_VyCc
setHistoryData
При вызове метода setHistoryData для просмотра версии истории документа в Р7 Document Server необходимо добавить token для ратифицирования параметров.
Полезная нагрузка для токена JWT в формате JSON должна иметь ту же структуру, что и параметр метода.
Список параметров для подписи строго не регламентирован, но мы рекомендуем указывать все отправляемые параметры:
{
"changesUrl": "https://example.com/url-to-changes.zip",
"key": "Khirz6zTPdfd7",
"previous": {
"key": "af86C7e71Ca8",
"url": "https://example.com/url-to-the-previous-version-of-the-document.docx"
},
"url": "https://example.com/url-to-example-document.docx",
"version": 2
}
Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов.
Дополнительные сведения о взаимодействии клиент-сервер службы Сервера документов см. в разделе Как это работает.
Образец токена:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaGFuZ2VzVXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tY2hhbmdlcy56aXAiLCJrZXkiOiJLaGlyejZ6VFBkZmQ3IiwicHJldmlvdXMiOnsia2V5IjoiYWY4NkM3ZTcxQ2E4IiwidXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tdGhlLXByZXZpb3VzLXZlcnNpb24tb2YtdGhlLWRvY3VtZW50LmRvY3gifSwidXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tZXhhbXBsZS1kb2N1bWVudC5kb2N4IiwidmVyc2lvbiI6Mn0.7gaOe1_4OvgRLYD0oGk_bMrVdPaLmgZVNIgQCUQdgoE
setMailMergeRecipients
При вызове метода setMailMergeRecipients для вставки данных получателя для слияния в файл необходимо добавить token для ратифицирования параметров.
Полезная нагрузка для токена JWT в формате JSON должна иметь ту же структуру, что и параметр метода.
Список параметров для подписи строго не регламентирован, но мы рекомендуем указывать все отправляемые параметры:
{
"fileType": "xlsx",
"url": "https://example.com/url-to-example-recipients.xlsx"
}
Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов.
Дополнительные сведения о взаимодействии клиент-сервер службы Сервера документов см. в разделе Как это работает.
Образец токена:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6Inhsc3giLCJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL3VybC10by1leGFtcGxlLXJlY2lwaWVudHMueGxzeCJ9.P3TjOyX1Tv3xAVRAc8qtNb-uFLD6FH_WErag_rbI6nQ
setRevisedFile
При вызове метода setRevisedFile для выбора документа для сравнения необходимо добавить token для ратифицирования параметров.
Полезная нагрузка для токена JWT в формате JSON должна иметь ту же структуру, что и параметр метода.
Список параметров для подписи строго не регламентирован, но мы рекомендуем указывать все отправляемые параметры:
{
"fileType": "docx",
"url": "https://example.com/url-to-example-document.docx"
}
Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов.
Дополнительные сведения о взаимодействии клиент-сервер службы Сервера документов см. в разделе Как это работает.
Образец токена:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6ImRvY3giLCJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL3VybC10by1leGFtcGxlLWRvY3VtZW50LmRvY3gifQ.t8660n_GmxJIppxcwkr_mUxmXYtE8cg-jF2cTLMtuk8
