Запрос с токеном в заголовке
Когда вы выполняете HTTP запросы от Сервера документов, для проверки подлинности запроса к нему добавляется заголовок авторизации с токеном. Когда вы выполняете HTTP запросы к Серверу документов, для проверки подлинности запроса к нему добавляется заголовок авторизации с токеном.
Данные для JSON Web Token содержат следующие поля:
- payload — объект, содержащий параметры запроса в JSON формате, если поле не пустое.
Входной запрос
- Запрос на получение статуса отредактированного документа
Проверка выполняется для входящих запросов с помощью команд от сервиса хранения документов к командному сервису документов.
{
"payload": {
"c": "info",
"key": "Khirz6zTPdfd7"
}
}
POST coauthoring/CommandService.ashx HTTP/1.1
Host: documentserver
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImMiOiJpbmZvIiwia2V5IjoiS2hpcno2elRQZGZkNyJ9fQ.hGQ8kquQWpg4MQYiSYaIzik0wotP1coAop6QfLruenA
{
"c": "info",
"key": "Khirz6zTPdfd7"
}
- Запрос на конвертацию документа
Проверка выполняется для входящих запросов с помощью команд от сервиса хранения документов к сервису конвертации документов.
{
"payload": {
"filetype": "docx",
"key": "Khirz6zTPdfd7",
"outputtype": "pdf",
"title": "Пример названия документа.docx",
"url": "https://example.com/url-to-example-document.docx"
}
}
Где example.com — имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.
POST ConvertService.ashx HTTP/1.1
Host: documentserver
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImZpbGV0eXBlIjoiZG9jeCIsImtleSI6IktoaXJ6NnpUUGRmZDciLCJvdXRwdXR0eXBlIjoicGRmIiwidGl0bGUiOiJFeGFtcGxlIERvY3VtZW50IFRpdGxlLmRvY3giLCJ1cmwiOiJodHRwOi8vZXhhbXBsZS5jb20vdXJsLXRvLWV4YW1wbGUtZG9jdW1lbnQuZG9jeCJ9fQ.Ec50Gvafu4niR2I1LPgETn1jkvvs1wKm0YeeI1RbRQs
{
"filetype": "docx",
"key": "Khirz6zTPdfd7",
"outputtype": "pdf",
"title": "Пример названия документа.docx",
"url": "https://example.com/url-to-example-document.docx"
}
Где example.com — имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.
- Request to document builder service
Проверка выполняется для входящих запросов с помощью команд от сервиса хранения документов к сервису по созданию документов
{
"payload": {
"async": true,
"url": "https://example.com/url-to-example-script.docbuilder"
}
}
Образец запроса в сервис по созданию документов
POST docbuilder HTTP/1.1
Host: documentserver
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImFzeW5jIjp0cnVlLCJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL3VybC10by1leGFtcGxlLXNjcmlwdC5kb2NidWlsZGVyIn19.JpHp_TB3XDacAhTTB4I0CE7SIESSE9aQUGDulbpYKTE
{
"async": true,
"url": "https://example.com/url-to-example-script.docbuilder"
}
Где example.com — это имя сервера, на котором установлена служба хранения документов. Дополнительные сведения о взаимодействии клиент-сервер службы Document Server см. в разделе Как это работает
Исходящие запросы
- Запрос на «callbackUrl» службой редактирования документов, когда последний пользователь закрыл документ для редактирования без изменений
Для исходящих запросов на адрес «callbackUrl» проверка выполняется сервисом редактирования документов.
{
"payload": {
"key": "Khirz6zTPdfd7",
"status": 4
}
}
POST url-to-callback.ashx HTTP/1.1
Host: example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImtleSI6IktoaXJ6NnpUUGRmZDciLCJzdGF0dXMiOjR9fQ.MfVoGT-aYuPJfjQAaxwBv7-CqBylDae2AF9K5TpLf-E
{
"key": "Khirz6zTPdfd7",
"status": 4
}
Где example.com — имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.
- Запрос в службу хранения документов на загрузку файла
Проверка подлинности производится для исходящих запросов к сервису хранения документов на скачивание файлов.
{
"payload": {
"url": "https://example.com/url-to-example-document.docx"
}
}
Образец запроса в службу хранения документов для скачивания файлаGET url-to-example-document.docx HTTP/1.1
Host: example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.LwimMJA3puF3ioGeS-tfczR3370GXBZMIL-bdpu4hOU
Где example.com — имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.