Versions Compared

Old Version 2

changes.mady.by.user Roman Nazarov

Saved on

compared with

New Version Current

changes.mady.by.user Vadim Belyakov

Saved on

Key

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

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

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

Параметры

...

запроса:

...

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

где, 

...

ПараметрОбязательныйОписание параметра
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 формате: yyyy-mm-ddThh:nn:ss.fff
dateTimeToДаКонечная граница временного периода в UTC формате: yyyy-mm-ddThh:nn:ss.fff

...

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

...

POST

...

http://127.0.0.1:10000/firserver/GetProtocols

Code Block
firserver/GetProtocols HTTP/1.1
Host: localhost:10000
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: e173f0b5-ed8d-649e-e4a3-5f751568f236

{
  "server_id": "1",
  "onlineRefresh": 1,
  "genders": [
    0,
    1,
    2
  ],
  "dateTimeFrom": "20172020-05-11T1614T16:25:55.687",
  "dateTimeTo": "20182020-05-12T1616T16:26:55.687",
  "cameraIds": [
    "1"
  ],
  "minAge": 0,
  "maxAge": 1000,
  "page": 1,
  "pageSize": 50,
  "sim_min": -1
}

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

...

:

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": 036.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": "1Doe",
                    "name": "1John",
                    "patronymic": "1White",
                    "comment": "1Senior developer",
                    "department": "1IT department"
                }
            ]
        }
    ],
    "ProtocolsTotal": 1,
    "Status": "OK"
}

где,

...

gender - пол:

  • 0 - неизвестный пол (далее пропускаю 0 - везде это значит что значение неизвестно)

  • 1 - мужчина

  • 2 - женщина

...

ethnicity - раса:

  • 1 - монголоидная раса

  • 2 - негроидная

  • 3 - европеоидная

  • 4 - восточно-индийская

...

emotion - эмоции:

  • 1 - злость

  • 2 - страх

  • 3 - радость

  • 4 - без эмоции

  • 5 - грусть

  • 6 - удивление

...

glasses - очки:

  • 1 - темные очки

  • 2- отсутствие

  • 3 - обычные

...

facialHair - растительность на лице:

  • 1 - борода

  • 2 - щетина

  • 3 - эспаньолка и усы

  • 4 - эспаньолка

  • 5 - усы

  • 6 - отсутствует

hairColor - цвет волос:

Параметры ответа:
...
1 - брюнет(ка)
...
2 - блондин(ка)
...
3 - шатен(ка)
...
4 - рыжий(ая)
ПараметрОписание параметра
idИдентификатор захваченного изображения
camera_idИдентификатор камеры, захватившей лицо
camera_nameНазвание камеры, захватившей лицо
timestamp Время захвата лица в UTC формате
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 - перекрытие
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 Отдел