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

Предыдущая страница Получение изображения по ID  Получение аналитических данных по времени Следующая страница

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

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

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

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

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

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

maxAge Нет

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

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

dateTimeFrom ДаВремя в UTC+0 формате, с момента которого необходимо получить данные
dateTimeTo ДаВремя в UTC+0 формате, до момента которого необходимо получить данные
genders Нет

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

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

faceModeНет

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

Если не указать, то faceMode=0

thresholdНет

Пороговое значение степени сравнения лиц. По умолчанию 0.8

Если не указать, то threshold=0.8

minPassesНет

Фильтр по минимальному числу проходов

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

maxPassesНет

Фильтр по максимальному числу проходов

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

cameraIds Нет

Идентификаторы камер в ПК Face-Интеллект

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

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

POST http://127.0.0.1:10000/firserver/GetAnalityc

{
 "server_id": "1",
 "minAge": 0,
 "maxAge": 1000,
 "dateTimeFrom": "2018-08-17T21:00:00.000",
 "dateTimeTo": "2018-09-18T20:59:59.000",
 "genders": [
 0,
 1,
 2
 ],
 "faceMode": 0,
 "threshold": 0.8,
 "minPasses": 1,
 "maxPasses": 10000,
 "cameraIds": [
 "1"
 ]
}

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

Заголовок

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

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

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

{
 "PassAndLikesList": [
 {
 "MainPass": {
 "Id": "53952CAF-3BBB-E811-8D01-005056C00008",
 "Timestamp": "2018-09-18T12:09:32.848",
 "Camera": "1",
 "Gender": 1,
 "Age": 31.4502
 },
 "BestPerson": {
 "Id": "5CC71799-48BB-E811-8D01-005056C00008",
 "Name": "Петр",
 "Surname": "Петров",
 "Patronymic": "Петрович",
 "Department": "Отдел 1",
 "Comment": "",
 "Timestamp": "2021-06-25T10:39:55.974",
 "ImageId": "98B73FA9-A1D5-EB11-AC0A-B42E999B6711",
 "AutoCreated": false,
 "LastRecognitionTimestamp": "2021-06-25T11:59:52.185",
 "RecognitionCount": 375,
 "revisions": [
        {
         "source": "8A91CD97-62D3-EB11-AC0A-B42E999B6711",
         "revision": "97B73FA9-A1D5-EB11-AC0A-B42E999B6711"
        }
 "Sim": 0.850095
 },
 "LikePasses": [
 {
 "Id": "1E1483A5-41BB-E811-8D01-005056C00008",
 "Timestamp": "2018-09-18T12:52:08.987",
 "Gender": 1,
 "Age": 31.4372,
 "Temperature": 0,
 "Emotion": 5,
 "Glasses": 2,
 "FacialHair": 6,
 "HairColor": 1,
 "HairType": 3,
 "Headwear": 13,
 "Liveness": 1,
 "Evasion": 1
 }
 ],
 "Total": 40,
 "Males": 40,
 "Females": 0
 }
 ],
 "ProcessedTotal": 1346,
 "ProcessedDuration": 83,
 "CompareCount": 18555,
 "Response": {
 "Status": "SUCCESS"
 }
}

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

ПараметрОписание параметра
PassAndLikesListСписок проходов уникальных лиц
MainPassДанные о первом проходе уникального лица (подробнее см. Получение протокола распознавания)
BestPersonДанные о лице из базы лиц и степень схожести эталонного лица с уникальным лицом, если такое лицо существует (подробнее см. Получение информации о всех пользователях из базы лиц)
TimestampВремя добавления лица в базу эталонных лиц в UTC+0 формате
ImageIdИдентификатор изображения эталонного лица из базы лиц
AutoCreated

True, если нераспознанное лицо было добавлено автоматически. False, если добавлено вручную

LastRecognitionTimestampВремя последнего прохода в UTC+0 формате
RecognitionCountКоличество проходов
LikePassesСписок с данными похожих проходов (аналогично MainPass). Не может иметь размер больше 5 элементов
TemperatureТемпература лица в градусах Цельсия
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 - маска надета неправильно
TotalОбщее количество уникальных лиц
MalesКоличество лиц мужского пола
FemalesКоличество лиц женского пола
ProcessedTotalОбщее количество обработанных лиц
ProcessedDurationВремя выполнения обработки лиц в миллисекундах
CompareCountОбщее количество сравнений лиц
ResponseОтвет
StatusСтатус выполненного запроса: SUCCESS - успешно, если ошибка - см. Список возможных ошибок Сервера распознавания лиц
  • No labels