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

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

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

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://1:1@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