View Source

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

POST http://логин_пользователя_Интеллект:пароль_пользователя_Интеллект@IP-адрес:порт/firserver/ReadPersons

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

Параметр	Обязательный	Описание параметра
server_id	Да	Идентификатор Сервера распознавания лиц в ПК Face-Интеллект
id	Нет	Идентификатор пользователя в ПК Интеллект Если не указать, в ответе вернется информация обо всех пользователях
page	Нет	Количество страниц с результатами Если не указать, то page=1
pageSize	Нет	Количество результатов на 1 странице Если не указать, то pageSize =1, т.е. на 1 странице будет 1 результат
departmentFilter	Нет	Идентификатор отдела Если не указать, в ответе вернется информация обо всех пользователях всех отделов

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

POST http://1:1@127.0.0.1:10000/firserver/ReadPersons

Получение информации о пользователях из всей базы лиц

{
 "server_id": "1",
 "objectType": "PERSON",
 "id": [

 ],
 "page": 1,
 "pageSize": 2
}

Получение информации о пользователях указанного отдела

{
 "server_id": "1",
 "departmentFilter":"1"
 "objectType": "PERSON",
 "id": [

 ],
 "page": 1,
 "pageSize": 2
}

Заголовки запросов:

Заголовок	Описание заголовка
Allow	Возвращает HTTP-метод, который используется в запросе
Content-Length	Показывает размер символов в байтах, получаемых в запросе
Content-Type	Возвращает тип получаемого запроса
Server	Определяет сервер, с которого приходит запрос
Access-Control-Request-Method	Возвращает HTTP-метод, который может использоваться в запросе
Access-Control-Origin	Показывает, может ли ответ сервера быть доступен коду, отправляющему запрос с данного источника
Date	Показывает время запроса

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

"PersonList": [
	{
            "Id": "1CEE737C-B5D4-EB11-AC0A-B42E999B6711",
            "Name": "",
            "Surname": "1CEE737C-B5D4-EB11-AC0A-B42E999B6711",
            "Patronymic": "",
            "Department": "3",
            "Comment": "",
            "Timestamp": "2021-06-24T06:29:16.199",
            "ImageId": "1EEE737C-B5D4-EB11-AC0A-B42E999B6711",
            "AutoCreated": true,
            "LastRecognitionTimestamp": "2021-06-24T06:29:28.270",
            "RecognitionCount": 1,
	}
],
 "Total": 220,
 "Response": {
 "Status": "OK"
 }

В ответе возвращаются пользователи в порядке времени добавления в базу данных (сначала последние добавленные).

Также, используя идентификатор из параметра PersonList.ImageId, можно получить фото пользователя отдельным запросом. См. Получение изображения по ID.

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

Параметр	Описание параметра
PersonList	Список пользователей с информацией из базы лиц
id	Идентификатор пользователя из базы лиц
name	Имя
surname	Фамилия
patronymic	Отчество
department	Отдел
comment	Комментарий
timestamp	Время добавления лица в базу эталонных лиц в UTC+0 формате
ImageId	Идентификатор изображения эталонного лица из базы лиц
AutoCreated	true, если нераспознанное лицо было добавлено автоматически
LastRecognitionTimestamp	Время последнего прохода в UTC+0 формате
RecognitionCount	Количество проходов
Total	Всего пользователей в базе лиц
Source	Идентификатор сервера в формате GUID
Response	Ответ
Status	Статус выполненного запроса: OK – успешно, если ошибка – см. Список возможных ошибок Сервера распознавания лиц