Go to documentation repository
Documentation for Face PSIM 1.0.1.
Previous page Next page
General request format:
POST http://IP-address:port/firserver/GetAnalityc
Request parameters:
| Parameter | Required | Parameter description |
|---|---|---|
| server_id | Yes | Identifier of the Face Recognition Server in Face PSIM |
| minAge | No | Minimum age of persons |
| maxAge | No | Maximum age of persons |
| dateTimeFrom | Yes | Time in UTC+0 format, starting from which the data should be obtained |
| dateTimeTo | Yes | Time in UTC+0 format, up to which the data should be obtained |
| genders | No | Gender of persons whose data should be obtained: 0 − Unknown, 1 − Males, 2 − Females |
| faceMode | No | Type of persons whose data should be obtained: 0 − all faces, 1 − only recognized faces, 2 − only unrecognized faces |
| threshold | No | Threshold value of the faces similarity degree |
| minPasses | No | Filter by the minimum number of passes |
| maxPasses | No | Filter by the maximum number of passes |
| cameraIds | No | Camera IDs in Face PSIM |
Request example:
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"
]
}
Response 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 if the code that sends the request from this source can access the server response |
| Date | Shows the time of the request |
Response example:
Response parameters:
| Parameter | Parameter description |
|---|---|
| PassAndLikesList | List of passes of unique faces |
| MainPass | Data on the first pass of a unique face (for more details, see Getting the recognition protocol) |
| BestPerson | Data about the face from the face database and the degree of similarity of the reference face with a unique face, if such a person exists (for more details, see Getting information about users) |
| 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 database |
| AutoCreated | true if the unrecognized face was added automaticallyи. false if it was added manually |
| LastRecognitionTimestamp | Time of the last pass in UTC+0 format |
| RecognitionCount | Number of passes |
| LikePasses | List with data of similar passes (similar to MainPass). Cannot be larger than 5 elements |
| Temperature | Facial temperature in degrees Celsius |
| Emotion | Emotion: 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 |
| FacialHair | Facial hair: 0 − undefined; 1 − beard, 2 − bristle, 3 − imperial beard and mustache, 4 − imperial beard, 5 − mustache, 6 − absent |
| HairColor | Hair color: 0 − undefined, 1 − brunet, 2 − blonde, 3 − chestnut hair, 4 − ginger, 5 − gray |
| HairType | Type of bald head: 0 − undefined, 1 − bald, 2 − with receding hairline, 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 cap |
| Liveness | Artificial face: 0 − undefined, 1 − no, 2 − yes |
| Evasion | Face concealment: 0 − undefined, 1 − face not covered, 2 − mask is on, 3 − tinted glasses, 4 − face partially covered, 5 − balaclava, 6 − other mask, 7 − mask is not on the right place |
| 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 request status: SUCCESS - successful, if error - see List of possible errors of the Face Recognition Server |
Overview
Content Tools