Токен в заголовке - Центр поддержки Р7

Запись опубликована:16.10.2022
Post category:Запрос
Запись изменена:16.06.2023

Запрос с токеном в заголовке

Когда вы выполняете 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"
}

Request to document builder service

Проверка выполняется для входящих запросов с помощью команд от сервиса хранения документов к сервису по созданию документов

{
    "payload": {
        "async": true,
        "url": "https://example.com/url-to-example-script.docbuilder"
    }
}

Где example.com — это имя сервера, на котором установлена служба хранения документов. Дополнительные сведения о взаимодействии клиент-сервер службы Document Server см. в разделе Как это работает

Образец запроса в сервис по созданию документов

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"
}

Исходящие запросы

Запрос на «callbackUrl» службой редактирования документов, когда последний пользователь закрыл документ для редактирования без изменений

Для исходящих запросов на адрес «callbackUrl» проверка выполняется сервисом редактирования документов.

Пример данных запроса на адрес «callbackUrl» сервисом редактирования документов, когда последний пользователь закрыл документ без изменений

{
    "payload": {
        "key": "Khirz6zTPdfd7",
        "status": 4
    }
}

Пример запроса на адрес «callbackUrl» сервисом редактирования документов, когда последний пользователь закрыл документ без изменений

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
}

Запрос в службу хранения документов на загрузку файла

Проверка подлинности производится для исходящих запросов к сервису хранения документов на скачивание файлов.

Пример данных для запроса к сервису хранения документов на скачивание файла

{
    "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

Токен включает в себя payload (полный URL-адрес документа, в приведенном выше примере это {«url: «http://example.com/url-to-example-document.docx»}), который также дублируется в заголовок в качестве хоста (example.com) и адрес документа, на который отправляется запрос GET (url-to-example-document.docx).
Запрос в службу хранения документов на загрузку данных об изменениях документа
Проверка выполняется для исходящих запросов к службе хранения документов для загрузки данных об изменениях документа. Пример полезной нагрузки запроса к службе хранения документов для загрузки данных об изменениях документа

{
    "payload": {
        "url": "https://example.com/url-to-document-changes.zip"
    }
}

Образец запроса в службу хранения документов на выгрузку данных об изменениях документа

GET url-to-changes.zip HTTP/1.1
Host: example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7InVybCI6Imh0dHBzOi8vZXhhbXBsZS5jb20vdXJsLXRvLWRvY3VtZW50LWNoYW5nZXMuemlwIn19.4CJ4F8x7VDMW72ss9VnIYGIwjRpBMYBBRXZ5aX2r2Y4

Где example.com — это имя сервера, на котором установлены менеджер документов и служба хранения документов. Дополнительные сведения о взаимодействии клиент-сервер службы Сервера документов см. в разделе Как это работает.Токен включает в себя полезную нагрузку (полный URL-адрес документа, в приведенном выше примере это {«url: «http://example.com/url-to-document-changes.zip»}), который также дублируется в заголовок в качестве хоста (example.com) и адрес документа, на который отправляется запрос GET (url-to-document-changes.zip).

Была ли полезна статья?

Спасибо, что помогаете нам стать лучше