Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

POST http://IP-адрес:порт/префикс/firserver/GetProtocols - получить протокол распознавания.

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

ПараметрОбязательныйОписание параметра
server_idДаИдентификатор Сервера распознавания лиц в ПК Face-Интеллект

onlineRefresh 

Да

Данный параметр обязательно должен иметь значение 1

genders

Нет

Пол: 0 - не определен, 1 - мужской, 2 - женский

Если не указать, то пол не учитывается

pageНет
Параметр количества

Количество страниц с результатами

Если не указать, то page=1

pageSize

Параметр размера страницы

Нет

Количество результатов на 1 странице

Если не указать, то pageSize =1, т.е. на 1 странице будет 1 результат

cameraIdsНет
cameraIdsmaxAgeМаксимальная граница возраста пользователяdateTimeFrom

Идентификаторы камер (GUID или идентификаторы в дереве объектов ПК Интеллект)

Если не указать, то выводятся результаты по всем камерам

sim_minНет

Типы лиц: -1 - все лица, 1 - только распознанные, 0 - только нераспознанные

Если не указать, то sim_min=-1

minAge
Минимальная граница возраста пользователя
Нет

Минимальный возраст лиц

Если не указать, то возраст не учитывается

maxAgeНет

Максимальный возраст лиц

Если не указать, то возраст не учитывается

dateTimeFromДа
Начальная граница временного периода в UTC формате: yyyy-mm-ddThh:nn:ss.fff
dateTimeToДаКонечная граница временного периода в UTC формате: yyyy-mm-ddThh:nn:ss.fff

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

POST http://localhost127.0.0.1:10000/firserver/GetProtocols

...

Code Block
{
  "server_id": "1",
  "onlineRefresh": 1,
  "genders": [
    0,
    1,
    2
  ],
  "dateTimeFrom": "2020-05-14T16:25:55.687",
  "dateTimeTo": "2020-05-16T16:26:55.687",
  "cameraIds": [
    "1"
  ],
  "minAge": 0,
  "maxAge": 1000,
  "page": 1,
  "pageSize": 50,
  "sim_min": -1
}

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

Expand
Code Block
{
    "Protocols": [
        {
            "id": "18D10CC2-9596-EA11-8A9A-B06EBF8119EF",
            "camera_id": "5",
            "camera_name": "grundig 5",
            "timestamp": "2020-05-15T10:20:54.657",
            "age": 55.4815,
            "gender": 2,
            
"ethnicity
"
: 3, "
emotion": 4,
            "glasses": 2,
            "facialHair": 6,
            "hairColor": 1,
            "hairType": 3,
            "headwear": 13,
            "liveness": 1,
            "evasion": 1,
            "temperature": 36.6,
            "fir": {
                "data": "rvOGvR0Oxbx76+a8kIHXPfbzkbwY7hA9vpS5PRdb0j32pg4+yqerPT6Ghjw/Vhy9PpMQvWHqmb2U5VQ8kic/vWIS/b0xXNq8kJ7hPU7MGT2qdxw9FdAJPFXwtLxGLUQ9wBJCPLPiB71UMoU8vhbHPOThqb3VaSg92qH0PHOj1zyEdaa9ulOxvVfWq71oyOo8twbWu3g+mD0SQvw8C/KhvEjElrspZFi9Q7xsu6FLoL1mLa492n3tvCyBl7wNLl8+n+6RvRQnCbzDDhw9EnCAPdSsmT2PsHa8n+6HvTd6Cj0qT3U9oFQMveIDNj0m7sU8eih0vYGvgT3INIc9tWfXvevQnr1QMmG92WGHvf7Ulzxz74a8aCmlvXAa6j0vEMO8ApXTvGsowLwOuzC9TpGtO0eUfbzBOF4+SUgqPQpEvbyr+K08NJQTve1zZLrt6kQ9lvwEvZCE/j0R9B693z+APJK7l7x6K+W9yPTmO8ai1jp630U9OKUUPujXET0WnPa8DIW7PE32Z73Fkke8kYNmvZg/Lb2bv+o95BUKvYRH47yr70S8ojApvaMX5bwC4Co9AuwNvSFoWTyaXa09ueWFvPZ+RT3w7Mk7HnsLvDsmBD32PAW9IuphvSZLpTyBN5W9+e4sPcuAXr2RNI288I5hvYAm3LtEHnm9FFVFvIo8VL0ishw+QHjDPGGbhr2sJZK8E3a5PYsDK73kgKu8cN4/PB3Z8z10AE+9HWm7PRJhdr5l7Tm9LjRHvZtTA7wTW+08nGa4PXmX0bs1mwk8xrGcPBgNfzyfF7A6vYPWPaRxUL3jK8e7Y3KOvX5i77z543o9Xh/9PF0eAD24hrG8VYl1vRQnhrxGpcm8uuOCOdmlAz0z2AG+0cCHu6l/Yz1XdlA9fHPnvAZuij2dv9g7hlbYu47LJb1fUFM9IpIcvSRgBr7RC4Y9GgFCPeuYTLyw2oe9wUZNPZAPGr0GlEK96x2nvY29ybyQdZE9/v4jvcPhXbu9D309YWkWPYfTTD4S3fc9BtZqu3cfMLydFbu9IgSjO1PYMjx0rUA9Z1qgvSmWSj3BBlm8DcuvPWBNHr0eOYA9r5eIPMbslL26mIi852wHPvVfOD1wWPk8gHECvSVsgr3bM7i9GNleu+Lbfj0UDY29VU0hvv3xUzxaiAY9DtccPfk+BD0M+iy9IZABvRr35DzOpsy9G7VWPVmkoD26GAE9JBptvbtnL73QTFA9+fs3veiXx7v76o09m130O4OzRT3zog09YTimvAlnO71mTac8BPmCPcVQ8LzJ/yY9EdYUPSJpc704YWA9OCaRvRmzOr6bnjg7vLHWPBcI0ryxdKq8WsZ9PIINOD00RzO9MVeIuw==",
                "engine": 3,
                "alg": 0
            },
            "Hits": [
                {
                    "id": "A5204509-9596-EA11-8A9A-B06EBF8119EF",
					"person_id": "2",
                    "sim": 0.249181,
                    "timestamp": "2020-05-15T10:15:44.807",
                    "surname": "Doe",
                    "name": "John",
                    "patronymic": "White",
                    "comment": "Senior developer",
                    "department": "IT department"
                }
            ]
        }
    ],
    "ProtocolsTotal": 1,
    "Status": "OK"
}

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

ПараметрОписание параметра
idИдентификатор захваченного изображения
camera_idИдентификатор камеры, захватившей лицо
camera_nameНазвание камеры, захватившей лицо
timestamp Время захвата лица в UTC формате
ageВозраст лица
gender 

Пол: 0 - неизвестноне определен1 - мужчина, 2 - женщина

ethnicity

Раса: 0 - неизвестно, 1 - монголоидная раса, 2 - негроидная, 3 - европеоидная, 4 - восточно-индийская

emotion

Эмоция: 0 - неизвестноне определен1 - злость, 2 - страх, 3 - радость, 4 - без эмоции, 5 - грусть, 6 - удивление

glasses

Очки: 0 - неизвестноне определен1 - темные очки, 2- отсутствие, 3 - обычные

facialHair

Растительность на лице: 0 - неизвестноне определен1 - борода, 2 - щетина, 3 - эспаньолка и усы, 4 - эспаньолка, 5 - усы, 6 - отсутствует

hairColor

Цвет волос: 0 - неизвестноне определен1 - брюнет(ка), 2 - блондин(ка), 3 - шатен(ка), 4 - рыжий(ая), 5 - седой(ая)

hairType

Тип лысины: 0 - неизвестноне определен1 - лысый, 2 - с залысиной, 3 - без лысины

headwear

Головной убор: 0 - неизвестноне определен1 - кепка, 2 - бандана, 3 - берет, 4 - шапка, 5 - ушанка, 6 - меховой капюшон, 7 - очки на голове8 - шляпа, 9 - шлем, 10 - капюшон, 11 - кепи, 12 - косынка, 13 - без головного убора, 14 - фуражка

liveness

Поддельное лицо: 0 - неизвестно, 1 - нет, 2 - да

evasion

Сокрытие лица: 0 - неизвестно, 1- нет, 2 - маска, 3 - темные очки, 4 - перекрытие

temperatureТемпература лица в градусах цельсия
firДанные вектора лица
dataШаблон (вектор) лица
engine

Используемый SDK: 1 - Cognitec, 2- VISIONLABS, 3 - TEVIAN, 4 - STC, 5 - внешний (Huawei)

algИспользуемый алгоритм распознавания и поиска лиц: 0 - ALG1, 1 - ALG2, 2 - PRECISE
HitsДанные распознанного лица из баз данных faceDB и intellect. Если лицо не распознано, то поле будет пустым
idИдентификатор изображения эталонного лица из базы лиц
person_id

Идентификатор соответствующего пользователя в ПК Интеллект

sim Процент схожести захваченного лица с эталонным лицом из базы лиц
timestamp Время появления изображения с захваченным лицом
surname Фамилия
name Имя
patronymic Отчество
commentКомментарий
department Отдел

...