Документерра: руководство пользователя

[API] Получение токена входа

Получение токена входа для авторизованного читателя. Чтобы узнать больше о механизме входа с помощью токенов и о том, как использовать токены, обратитесь к Механизму входа с помощью токенов.

GET /users/{pr-login}/tokens? exp={exp-date}&muse={is-multiuse}

Авторизация

Этот запрос требует базовой авторизации.

Параметры запроса

Параметры пути

pr-login	string	Вход авторизованного читателя, для которого выдается токен входа.

Параметры поискового запроса

exp	string	[опционально] Временная метка ISO 8601 даты истечения срока действия токена. Часовой пояс GMT. Значение по умолчанию — 30 минут с текущего момента.
muse	bool	[опционально] Следует ли ограничить использование токена одним входом. Если условие true (верно), токен можно использовать неограниченное количество раз, пока не истечет срок его действия. По умолчанию значение false (ложно).

Образцы

Образец запроса

Copy Code

Bash (Unix Shell)

curl --location -g --request GET 'https://{portal-url}/api/v1/users/pr1/tokens?exp=2077-69-42T02:35:00&muse=true'

Образец тела ответа

Copy Code

JSON

{
    "expirationDate": "2077-12-31T02:35:00Z",
    "token": "SMxf5RlJ586y4iYWemQyECH51ueoOdBF",
    "userName": "pr1",
    "isMultiUse": true
}

Поля ответа

expirationDate	Временная метка ISO 8601 даты истечения срока действия токена. Часовой пояс GMT.
token	Сгенерированный токен входа.
userName	Логин авторизованного читателя.
isMultiUse	Определяет, можно ли использовать токен несколько раз, т.е. не ограничивать токен первым использованием.

[API] Изменение профиля авторизованного читателя