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

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

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

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

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

  • Запрос на «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
}

Где 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 — имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.

  • Токен включает в себя 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).