Как использовать токен для входа

В этой статье показано, как создать токен входа и использовать его для авторизации пользователей в Документерре.

  1. С помощью API Документерры вызовите метод Получение токена входа. Укажите:
    • логин авторизованного читателя, для которого нужен токен,
    • должен ли он быть многоразовым,
    • срок действия токена.

    Если у вас ещё нет авторизованных читателей, узнайте, как их создать.

  2. В ответе вы получите токен в поле token. Скопируйте его вручную или извлеките программно:
    JSON
    {
        "expirationDate": "2077-12-31T02:35:00Z",
        "token": "SMxf5RlJ586y4iYWemQyECH51ueoOdBF",
        "userName": "pr1",
        "isMultiUse": true
    }
  3. Вручную или программно добавьте токен в ссылку на закрытую документацию в качестве параметра t. Пример:
    https://library.documenterra.net/articles/my-publication/my-topic?t=SMxf5RlJ586y4iYWemQyECH51ueoOdBF

  4. Отправьте эту ссылку читателю или разместите её в приложении или на сайте.

При переходе по этой ссылке, пользователь автоматически авторизуется в вашем портале Документерры как читатель под указанным логином.

Подробнее о токенах для входа читайте в статье Механизм входа с помощью токена.