Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
borderColor#CCCCCC
bgColor#FFFFFF
titleBGColor#F0F0F0
borderStylesolid
titleНа странице:
Table of Contents

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

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

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

POST http://IP-адрес:порт/web2/secure/persons/granted?

{

"is_out={": "is_out}&",

"acr_id={": "acr_id",

"card": "card"

}&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",

"=0&acr_id=1&card=333": "1",

"card": "333"

}

Результат:

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

Code Block
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"

}&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",

"=1&acr_id=1&card=7777&comment=comment": "1",

"card": "7777",

"comment": "comment"

}

Результат:

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

Code Block
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"

}&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"

}1&card=7777

Результаты:

Code Block
{ "description": "Access OK", "status": "OK"} // у пользователя есть доступ
{ "description": "No Access Level", "status": "Error"} // у пользователя нет доступа
{ "description": "IdNo notsuch foundperson", "status": "Error"} // пользователь с таким ID не найден