Documentation for Face Intellect 8.0-8.1. Documentation for other versions of Intellect is available too.
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-Intellect |
| 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-Intellect |
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"
]
}
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 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 |