Get

Function

It is used to get the AI > Repeat Customer:FilterSnapedFaces parameters.

Request Message

Parameter Description

Table 1

ParameterRangeTypeDescription
Engine0intSearch engine, 0 or 1, should be consistent with /API/AI/SnapedFaces/Search
MinInterval5intThe time interval between face appearance, unit: second. If it is less than this value, it should not be included in the statistics, and the "bValid" field in the response result indicates whether it should be included in the statistics
Similarity70unsigned intSimilarity to use when filtering
FilterJson ObjectThe target face to be screened. JSON show as follow Table 2
FtIdSetJson ObjectThe collection to be filtered. JSON show as follow Table 3

Table 2

ParameterRangeTypeDescription
UUId200053unsigned intThe unique identifier of the captured face, corresponding to the UUId in /API/AI/SnapedFeaturesId/Get
FtId58unsigned intThe feature value Id of the captured face corresponds to FtId in /API/AI/SnapedFeaturesId/Get

Table 3

ParameterRangeTypeDescription
UUIds[200053, 200054, ...]unsigned int arrayThe elements in the array represent the unique identification of the captured face
FtIds[58, 59, ...]unsigned int arrayThe elements in the array represent the feature value Id of the captured face, which corresponds to the Id in "UUIds" one by one

Sample:

POST /API/AI/FilterSnapedFaces/Get HTTP/1.1

{
	"version": "1.0",
	"data": {
		"MsgId": "",
		"Engine": 0,
		"MinInterval": 0,
		"Similarity": 70,
		"Filter": {
			"UUId": 20402,
			"FtId": 20402
		},
		"FtIdSet": {
			"UUIds": [20402, 20403, 20408, 20404, 20405, ...],
			"FtIds": [20402, 20403, 20408, 20404, 20405, ...]
		}
	}
}

Response Message

Parameter Description

Table 4

ParameterRangeTypeDescription
MsgIdnull
Result0intReturns the result of the face ID matching the filter in the target collection, 0 means success. see Table 5 for details
Count6intThe number of faces filtered out
MatchedIds[200053, 200059, ...]unsigned int arrayThe elements in the array represent the unique identification of the captured face
Counting[1, 0, 0, 1, 1, ...]int arrayThe elements in the array indicate whether the corresponding face can be used for counting statistics. If the interval is less than the minimum interval, the value is 0 and should not be included in the statistics. Otherwise, it is 1 and should be included in the statistics.

Table 5

Result TypeCOMMENT
AORT_SUCCESS = 0success
AORT_NO_DB = -1no database
AORT_DB_EXEC_FAILED = -2Database execution failed
AORT_CALC_FEATURE_FAILED = -3feature extraction failed
AORT_CANCELED = -4Cancelled
AORT_NO_DISK = -5no hard drive
AORT_DISK_ERROR = -6hard disk error
AORT_EXIST = -7existed
AORT_GROUP_INVALID = -8group invalid
AORT_NOT_EXIST = -9does not exist
AORT_MORE_FILE_EXIST = -10File already exists
AORT_SEARCH_ERROR = -11search error
AORT_OVER_MAX_COUNT = -12limit exceeded
AORT_UPDATING_FEATURE = -13Updating feature values
AORT_NO_USABLE_IPC = -14No IPC available for eigenvalue calculation
AORT_INVALID_PARAM = -15invalid parameter
AORT_INVALID_FORMAT = -16wrong format
AORT_INVALID_RES = -17wrong resolution
AORT_INVALID_MEM = -18file too large error
AORT_CREAT_FAILED = -19Creation failed
AORT_MD5_NOT_MATCH = -20MD5 mismatch
AORT_POS_ERROR = -21location error
AORT_SIZE_ERROR = -22wrong size
AORT_NOT_READY = -23not ready
AORT_INVALID_DB = -24invalid database

Sample:

HTTP/1.1 200 OK
Content-Type: application/json

{
	"data": {
		"MsgId": "",
		"Result": 0,
		"Count": 189,
		"MatchedIds": [20402, 20404, 20406, 20410, 20412,...],
		"Counting": [1, 1, 1, 1, 1, 1, 1, 1,...]
	}
}

Error Code

See Response Messages Body and Common error_code for more information.