Состояние учетной записи#

Проверка состояния учетной записи#

Метод

GET https://login.company.com/blitz/api/v3/users/{subjectId}/state

Проверка состояния учетной записи:

наличие блокировки по причине неактивности;
наличие запрета на блокировку по причине неактивности.

Необходимые разрешения: blitz_api_usec или blitz_api_sys_usec.

Примеры

Запрос

GET /blitz/api/v3/users/d2580c98-e584-4aad-a591-97a8cf45cd2a/state HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
Cache-Control: no-cache

Ответы

Состояние учетной записи еще не инициализировано (учетная запись только создана или еще не использовалась до входа с момента появления функции)#

{
  "name": "initial"
}

Учетная запись активна#

{
  "name": "active",
  "checkedOn": 1688106755
}

Примечание

В параметре checkedOn хранится временная отметка последней проверки состояния.

Учетная запись заблокирована по причине длительной неактивности#

{
  "name": "inactivityLock",
  "on": 1688106646
}

Примечание

В параметре on хранится время блокировки.

Учетная запись находится в списке исключений и не может быть заблокирована по причине неактивности до наступления даты из параметра till#

{
  "name": "untouchable",
  "till": 1689106755
}

Примечание

Если параметр till отсутствует, то учетная запись не может быть вообще заблокирована по причине неактивности.

Изменение состояния учетной записи#

Метод

POST https://login.company.com/blitz/api/v3/users/{subjectId}/state

Изменение состояния учетной записи пользователя.

Необходимые разрешения: blitz_api_sys_usec_chg.

Тело запроса

Возможные параметры:

name - назначаемое состояние. Можно назначить только состояние untouchable;
till - необязательный параметр, в котором можно указать время, до которого учетной записи назначается состояние untouchable. Для отмены состояния untouchable можно назначить параметру till текущее время.

Возвращает

В случае успешного вызова HTTP 204 No Content.

Пример

Запрос#

POST /blitz/api/v3/users/d2580c98-e584-4aad-a591-97a8cf45cd2a/state HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
Content-Type: application/json

{
    "name": "untouchable",
    "till": 1689106755
}