Кросс-авторизация через API

Кросс-авторизация позволяет пользователям открывать документы в редакторе Smartcat, не вводя логин и пароль. Вот как это работает.

Чтобы участник команды мог открыть редактор по кросс-ссылке, его нужно сперва назначить на проект. Неназначенные пользователи не смогут открыть редактор по этой ссылке. Назначить пользователя можно методом POST document/assign. Обязательные параметры — идентификатор документа в формате documentId_languageId, номер этапа (stageNumber) и id пользователя. Остальные параметры необязательны.

Пример: document/assign

Request URL: 
https://smartcat.ai/api/integration/v1/document/assign?documentId={documentId_languageId}&stageNumber=1

Headers:
Content-Type: application/json
Authorization: Basic dGVzdGFwaToxMjM0NTY=

Body:
{
  "executives": [
    {
        "id": "f8fb8870-a7fc-4ff5-8a44-34a7cf4a0c02",
    }
  ],
}

Параметр stageNumber означает номер этапа перевода. Например, 1 — перевод, 2 — редактура и так далее. (Конкретные названия этапов зависят от настроек проекта.)

Обратите внимание: пользователь уже должен быть зарегистрирован в Smartcat и добавлен в вашу команду. Вы можете это сделать также через API.

Назначив пользователя на документы, вы можете создать для него кросс-ссылку методом GET document/getAuthUrl. Обязательные параметры — идентификатор документа в формате documentId_languageId и id пользователя. В ответ метод вернёт ссылку для кросс-атворизации.

Пример: document/getAuthUrl

Request URL: 
https://smartcat.ai/api/integration/v1/document/getAuthUrl?userId={userId}&documentId={documentId_languageId}

Headers:
Authorization: Basic ZG0wMTpRd2VydHkxMjM=

Обратите внимание: ссылка действует только 30 секунд.

Понравилось?

4

Похожие статьи:

    Нет похожих статей