Документация для версии Интеллект 4.13. Документация на другие версии также доступна.

Предыдущая страница Получение списка пользователей  Команды, используемые для интеграции ЕЦХД Следующая страница

Запросы granted и denied разрешают/запрещают проход пользователя, запрос check возвращает статус доступа пользователя к проходу. Запросы работают, если создана и настроена Виртуальная точка доступа под объектом Веб-сервер 2.0.

Вход/выход одобрен

Общий формат запроса:

POST http://IP-адрес:порт/web2/secure/persons/granted?is_out={is_out}&acr_id={acr_id}&card={card}

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

Параметр

Обязательный

Описание

acr_idДаID виртуальной точки доступа
cardДаНомер карты пользователя
is_outНет

0 – вход

1 – выход

По умолчанию (если параметр не указан) is_out=0

В результате запроса в системе от виртуальной точки доступа генерируется событие ACR ACCESS_IN (вход) или ACCESS_OUT (выход), содержащее параметры name, surname, PERSON.id и region_id. Если acr_id указан неверно, то вернётся ошибка «Region id not found».

Пример запроса:

POST http://127.0.0.1:8085/web2/secure/persons/granted?is_out=0&acr_id=1&card=333

Результат:

Генерируются события в системе:

Event : WEB2|1|REQUEST_PERSON_GRANTED|slave_id<User333>,fraction<83>,owner<User333>,date<09-09-21>,guid_pk<{683808B9-4B11-EC11-91AD-1C1B0DE673A6}>,is_out<0>,core_global<1>,acr_id<1>,login<1>,card<333>,request_uuid<d3c5f251-24e7-4ac3-9525-30bc84c400c3>,time<11:55:55>
React : ACR_WEB2|1|ACCESS_IN|surname<123123>,region_id<1.1>,name<>,PERSON.id<2>
React : WEB2|1|RESPONSE_ACCESS|request_uuid<d3c5f251-24e7-4ac3-9525-30bc84c400c3>

Вход/выход не одобрен

Общий формат запроса:

POST http://IP-адрес:порт/web2/secure/persons/denied?is_out={is_out}&acr_id={acr_id}&card={card}&comment={comment}

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

Параметр

Обязательный

Описание

acr_idДаID виртуальной точки доступа
cardДаНомер карты пользователя
is_outНет

0 – вход

1 – выход

По умолчанию (если параметр не указан) is_out=0

commentНет

Комментарий

В результате запроса в системе от виртуальной точки доступа генерируется событие ACR ACCESS_DENIED, содержащее параметры name, surname, PERSON.id, region_id и comment. Если acr_id указан неверно, то вернётся ошибка «Region id not found».

Пример запроса:

POST http://127.0.0.1:8085/web2/secure/persons/denied?is_out=1&acr_id=1&card=7777&comment=comment

Результат:

Генерируются события в системе:

Event : WEB2|1|REQUEST_PERSON_DENIED|slave_id<User7777>,fraction<422>,owner<User7777>,date<09-09-21>,comment<comment>,guid_pk<{AFE3C407-4E11-EC11-91AD-1C1B0DE673A6}>,is_out<1>,core_global<1>,acr_id<1>,login<1>,card<7777>,request_uuid<1cffc4c2-7ed5-4501-ba67-386e361e7b27>,time<12:12:19>
React : ACR_WEB2|1|ACCESS_DENIED|surname<123123>,region_id<1.1>,name<>,PERSON.id<2>,comment<comment>
React : WEB2|1|RESPONSE_ACCESS|request_uuid<1cffc4c2-7ed5-4501-ba67-386e361e7b27>

Проверка доступа к проходу

Общий формат запроса:

POST http://IP-адрес:порт/web2/secure/persons/check?acr_id={acr_id}&card={card}

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

Параметр

Обязательный

Описание

acr_idДаID виртуальной точки доступа
cardДаНомер карты пользователя

Запрос возвращает ответ в формате JSON, содержащий результаты проверки пользователя.

Параметры ответа:

Параметр

Описание

description

No Access Level – нет доступа
Access OK – есть доступ
No such person – такого пользователя нет
Internal Error – внутренняя ошибка
No access tz – нет доступа к временной зоне
No access date range – не указан диапазон дат с разрешенным доступом
Is locked – пользователь заблокирован
Id not found – параметр card пустой или отсутствует

status

OK – доступ есть

Error – ошибка доступа

Пример запроса:

POST http://127.0.0.1:8085/web2/secure/persons/check?acr_id=1&card=7777

Результаты:

{ "description": "Access OK", "status": "OK"} // у пользователя есть доступ
{ "description": "No Access Level", "status": "Error"} // у пользователя нет доступа
{ "description": "No such person", "status": "Error"} // пользователь не найден
  • No labels