Page History

General request format:

...

POST http://

...

AxxonPSIM_user_login:AxxonPSIM_user_password@IP address:port/firserver/GetAnalityc

Request parameters:

Parameter	Required	Parameter description
server_id	Yes	Identifier of the Face

Recognition Server

recognition server in Face PSIM
minAge	No	Minimum age of persons If not specified, age is not taken into account
maxAge	No	Maximum age of persons If not specified, age is not taken into account
dateTimeFrom	Yes	Time in UTC+0 format

,

starting from which you want to get the data

should be obtained


dateTimeTo	Yes	Time in UTC+0 format

,

up to which you want to get the data

should be obtained


genders	No	Gender of persons

whose data should be obtained

: 0

— Unknown

—Unknown, 1

— Males

—Males, 2— Females

If not specified, gender is not taken into account

faceMode

No

Type of persons

whose data should be obtained

: 0

— all

—all faces, 1

— only

—only recognized faces, 2

— only

—only unrecognized faces

If not specified, then faceMode=0

threshold

No

Threshold value of the faces similarity

degree

level. The default value is 0.8

If not specified, then threshold=0.8

minPasses

No

Filter by the minimum number of

passes

accesses

If not specified, filter is not taken into account

maxPasses

No

Filter by the maximum number of

passes

accesses

If not specified, filter is not taken into account

cameraIds

No

Camera

IDs in

ID in Face PSIM

If not specified, results for all cameras are returned

Request example:

POST POST http://1271:1@127.0.0.1:10000/firserver/GetAnalityc

Code Block

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

Request headlines:

Headline	Headline description
Allow	Returns the HTTP method used in request
Content-Length	Shows the size of characters in bytes , received in the request
Content-Type	Returns the type of received request
Server	Specifies the server from which the request comes
Access-Control-Request-Method	Returns the HTTP method that can be used in the request
Access-Control-Origin	Indicates Shows if the server response can be accessed by the code that sends the a request from this source can access the server response
Date	Shows the time of the request

Response example:

Expand

title	Click to expand...

Code Block

{
 "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": "John",
 "Surname": "Wick",
 "Patronymic": "",
 "Department": "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,
 "Camera": "1"
 },
 {
 "Id": "F10CD78D-41BB-E811-8D01-005056C00008",
 "Timestamp": "2018-09-18T12:51:33.907",
 "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"
 }
}

Response parameters:

Parameter	Parameter description
PassAndLikesList	List of

passes

accesses of unique faces
MainPass	Data on the first

pass

access of a unique face (for more details, see

Getting

Get the recognition protocol)
BestPerson	Data about the face from the face database and the

degree of

similarity level of the reference face

with

between a unique face, if such a person exists (for more details,

see Getting

see Get information about users from a specified department or the entire face database)
Timestamp	Time of adding a face to the reference face database in UTC+0 format
ImageId	Identifier of the reference face image from the

faces

face database
AutoCreated	true

if

if the unrecognized face was added automatically

и

.

false

False if it was added manually
LastRecognitionTimestamp	Time of the last

pass

access in UTC+0 format
RecognitionCount	Number of

passes

accesses
LikePasses	List with data of similar

passes

accesses (similar to MainPass). Cannot be

larger

greater than 5 elements

Temperature

Facial

Face temperature in degrees Celsius
Emotion	Emotion:

0 — undefined, 1 — rage, 2 — fear, 3 — happiness, 4 — without emotion, 5 — sadness, 6 — astonishment

0—undefined, 1—rage, 2—fear, 3—happiness, 4—without emotion, 5—sadness, 6—astonishment
Glasses	Glasses:

0 — undefined, 1 — tinted glasses, 2 — without glasses, 3 — glasses

0—undefined, 1—tinted glasses, 2—without glasses, 3—glasses
FacialHair	Facial hair:

0 — undefined; 1 — beard, 2 — bristle, 3 — imperial

0—undefined; 1—beard, 2—bristle, 3—imperial beard and mustache,

4 — imperial

4—imperial beard,

5 — mustache, 6 — absent

5—mustache, 6—absent
HairColor	Hair color:

0 — undefined, 1 — brunet, 2 — blonde, 3 — chestnut hair, 4 — ginger, 5 — gray

0—undefined, 1—brunet, 2—blonde, 3—chestnut hair, 4—ginger, 5—gray
HairType	Type of bald head:

0 — undefined, 1 — bald, 2 — with

0—undefined, 1—bald, 2—with receding hairline,

3 — without

3—without bald head
Headwear	Headwear:

0 — undefined, 1 — cap, 2 — bandana, 3 — beret, 4 — beanie, 5 — trapper hat, 6 — fur hood, 7 — glasses on head, 8 — hat, 9 — helmet, 10 — hood, 11 — kepi, 12 — headscarf, 13 — without headwear, 14 — peaky

0—undefined, 1—cap, 2—bandana, 3—beret, 4—beanie, 5—trapper hat, 6—fur hood, 7—glasses on head, 8—hat, 9—helmet, 10—hood, 11—kepi, 12—headscarf, 13—without headwear, 14—peaky cap
Liveness	Artificial face:

0 — undefined, 1 — no, 2 — yes

0—undefined, 1—no, 2—yes
Evasion	Face concealment:

0 — undefined, 1 — face

0—undefined, 1—face not covered,

2 — mask

2—mask is on,

3 — tinted glasses, 4 — face

3—tinted glasses, 4—face partially covered,

5 — balaclava, 6 — other

5—balaclava, 6—other mask, 7 — mask

is not on the right place

isn't on properly
Total	Total number of unique faces
Males	Number of males
Females	Number of females
ProcessedTotal	Total number of processed faces
ProcessedDuration	Execution time of the faces processing in milliseconds
CompareCount	Total number of the face comparisons
Response	Response
Status

Completed

Status of the completed request

status

:

SUCCESS — successful

SUCCESS—successful, if

error — see

error—see List of possible errors of the Face

Recognition Server

recognition server

Page tree

Versions Compared

Old Version 5

New Version Current

Key

General request format:

Request parameters:

Request example:

Request headlines:

Response example:

Response parameters: