Error List

Missing apiKey
{"error":"MISSING_ARGUMENT: apiKey","request_id":null}
Wrong apiKey
{"error":"INVALID_API_KEY","request_id":null}
API key expired
{
    "status": "error",
    "message": "API_KEY_EXPIRED",
    "result": null
}
Maximum API call hit
{
    "status": "error",
    "message": "MAX_API_CALL_EXCEEDED",
    "result": null
}
Missing imageIdCard/imageBest
{"error":"MISSING_ARGUMENTS: imageIdCard or imageBest","request_id":null}
imageIdCard/imageBest's file size more than 3MB
{"error":"PAYLOAD_TOO_LARGE"}
Invalid imageIdCard/imageBest Format(Support:jpg、jpeg、png)
{"error":"Photo format error","request_id":null}
Invalid imageIdCard/imageBest has no face detected
{"error":"FACE_NOT_FOUND","request_id":"xxxxxxxxxx"}

Error messages

Error

Description

FACE_TOO_CLOSE

A distance between face and camera is too small for preprocessing issues

FACE_CLOSE_TO_BORDER

Face is too close to one or more borders. May reduce the accuracy of spoofing detection because edges of face may not be seen

FACE_CROPPED

Face is cropped. May reduce the accuracy of spoofing detection because edges of face may not be seen

FACE_IS_OCCLUDED

There is occlusion on the face or it is difficult to see face, which degrades the quality of liveness

FACE_NOT_FOUND

Face detector can't find face on image

TOO_MANY_FACES

Face detector found more than one face on image

FACE_TOO_SMALL

Facial area is not big enough for analysis. Either interpupillary distance(80px) or face size(224 px) is below the configured value.

FACE_ANGLE_TOO_LARGE

Facial out-of-plane rotation angle is extremely large

FAILED_TO_PREDICT_LANDMARKS

Landmarks prediction error

UNKNOWN

Unhandled exception in the code

Last updated