View Source

General request format:

POST http://IP-address:port/firserver/GetAnalitycByTime

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
cameraIds	No	Camera IDs in Face Intellect
genders	Yes	Gender of persons whose data should be obtained: 0 - Unknown, 1 - Males, 2 - Females
returnLocalTime	No	Time format of the face capture: 0 - time in UTC+0 format, 1- local time of the Server
timePeriod	No	Type of grouping the analytic data: 0 - by hour, 1 - by day, 2 - by month, 3 - by year

Request example:

POST http://127.0.0.1:10000/firserver/GetAnalitycByTime

{
  "server_id": "1",
  "minAge": 20,
  "maxAge": 30,
  "dateTimeFrom": "2019-02-25T21:00:00.000",
  "dateTimeTo": "2019-02-29T20:59:59.000",
  "cameraIds": [
    "1"
  ],
  "genders": [
    0
    1,
    2
  ],
  "returnLocalTime" : 0,
  "timePeriod" : 0
}

Response example:

{
    "Rows": [
        {
            "timestamp": "2019-02-27T180000.000",
            "value": [
                {
                    "age": 27,
                    "gender": {
                        "males": 10,
                        "females": 9,
                        "unknown": 0
  					},
					"smile": {
 						"males": 3,
 						"females": 1,
						"unknown": 0
					},
					"angry": {
						"males": 1,
  						"females": 2,
  						"unknown": 0
                	},
					"fear": {
 						"males": 1,
 						"females": 2,
						"unknown": 0
					},
					"happiness": {
						"males": 1,
  						"females": 1,
  						"unknown": 0
                	},
					"neutral": {
 						"males": 2,
 						"females": 1,
						"unknown": 0
					},
					"sadness": {
						"males": 1,
  						"females": 1,
  						"unknown": 0
                	},
					"surprise": {
						"males": 1,
  						"females": 1,
  						"unknown": 0
                	}
				}
            ]
        }
    ]
    "Response": {
        "Status": "SUCCESS"
    }
}

Response parameters:

Parameter	Parameter description
Rows	List of unique faces
timestamp	First pass time in UTC+0 format
value	List of additional face characteristics (for more details, see Getting the recognition protocol)
Response	Response
Status	Completed request status: SUCCESS - successful, if error - see List of possible errors of the Face Recognition Server