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

Предыдущая страница Следующая страница

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

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

POST http://IP-адрес:порт/firserver/GetProtocols

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

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

onlineRefresh 

Да

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

genders

Нет

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

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

pageНет

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

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

pageSize

Нет

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

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

cameraIdsНет

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

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

sim_minНет

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

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

minAgeНет

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

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

maxAgeНет

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

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

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

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

POST http://127.0.0.1:10000/firserver/GetProtocols

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

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

Заголовок

Описание заголовка

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

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

{
    "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,
            "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",
					"person_guid": "D5E68CD2-F4D7-EB11-AC0A-B42E999B6711",
                    "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+0 формате
ageВозраст лица
gender 

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

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 - лицо частично перекрыто, 5 - балаклава, 6- другая маска, 7 - маска надета неправильно

temperatureТемпература лица в градусах Цельсия
firДанные вектора лица
dataШаблон (вектор) лица
engineИспользуемый SDK: 1 - Cognitec, 2- VISIONLABS, 3 - TEVIAN, 4 - STC
algИспользуемый алгоритм распознавания и поиска лиц: 0 - ALG1, 1 - ALG2, 2 - PRECISE
HitsДанные распознанного лица из баз данных faceDB и intellect. Если лицо не распознано, то поле будет пустым
idИдентификатор изображения эталонного лица из базы лиц
person_id

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

sim Процент схожести захваченного лица с эталонным лицом из базы лиц
surname Фамилия
name Имя
patronymic Отчество
commentКомментарий
department Отдел
StatusСтатус выполненного запроса: OK- успешно, если ошибка - см. Список возможных ошибок Сервера распознавания лиц
person_guid

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

  • No labels
Error formatting macro: children: java.lang.NullPointerException