FaceSDKResultCode
This enumeration lists result codes returned by the Face SDK core library.
| Value | Name | Description |
|---|---|---|
| 0 | FACER_OK |
No issues. The process completed successfully. |
| 1 | FR_IMAGE_EMPTY |
Cannot read image. The file may not be a valid image format or could be corrupted. |
| 2 | FR_FACE_NOT_DETECTED |
Face not detected. |
| 3 | FR_LANDMARKS_NOT_DETECTED |
Landmarks not detected. |
| 4 | FR_FACE_ALIGHNER_FAILED |
An internal processing error occurred. Contact our support team. |
| 5 | FR_DESCRIPTOR_EXTRACTOR_ERROR |
An internal processing error occurred. Contact our support team. |
| 6 | FR_IMAGE_DECODE_ERROR |
Cannot read image. The image may be corrupted. |
| 7 | FR_INTERNAL_ERROR |
An internal processing error occurred. Contact our support team. |
| 199 | FACER_CONFIG_ERROR |
An internal processing error occurred. Contact our support team. |
| 200 | FACER_NO_LICENSE |
No appropriate license. Ensure that your license is valid, the required features are enabled, and the environment is configured correctly. See the Installation Guide. |
| 201 | FACER_IS_NOT_INITIALIZED |
An internal processing error occurred. Contact our support team. |
| 202 | FACER_COMMAND_IS_NOT_SUPPORTED |
Incorrect request parameters. Check that the request matches the specification. See OpenAPI documentation. |
| 203 | FACER_COMMAND_PARAMS_READ_ERROR |
The worker failed because the request parameters are invalid. Check that the request follows the correct format. See OpenAPI documentation. |
| 224 | FACER_LESS_THAN_TWO_IMAGES_IN_REQUEST |
While using Match, fewer than two images were provided. |
| 227 | FACER_VIDEO_DECODE_ERROR |
An internal processing error occurred. Contact our support team. |
| 228 | FACER_NOT_ENOUGH_FRAMES |
An internal processing error occurred. Contact our support team. |
| 229 | FACER_OUTPUT_IS_NOT_DEFINED |
An internal processing error occurred. Contact our support team. |
| 230 | FACER_CLOSED_EYES_DETECTED |
An internal processing error occurred. Contact our support team. |
| 231 | FACER_LOW_QUALITY |
An internal processing error occurred. Contact our support team. |
| 232 | FACER_HIGH_ASYMMETRY |
An internal processing error occurred. Contact our support team. |
| 233 | FACER_FACE_OVER_EMOTIONAL |
An internal processing error occurred. Contact our support team. |
| 234 | FACER_SUNGLASSES_DETECTED |
An internal processing error occurred. Contact our support team. |
| 235 | FACER_SMALL_AGE |
An internal processing error occurred. Contact our support team. |
| 236 | FACER_HEADDRESS_DETECTED |
An internal processing error occurred. Contact our support team. |
| 237 | FACER_FACES_NOT_MATCHED |
Liveness spoofing attempt detected. |
| 238 | FACER_IMAGES_COUNT_LIMIT_EXCEEDED |
For the Match function, only two images of the same type are allowed. |
| 239 | FACER_MEDICINE_MASK_DETECTED |
An internal processing error occurred. Contact our support team. |
| 240 | FACER_OCCLUSION_DETECTED |
Liveness spoofing attempt detected. |
| 242 | FACER_FOREHEAD_GLASSES_DETECTED |
Liveness spoofing attempt detected. |
| 243 | FACER_MOUTH_OPENED |
Liveness spoofing attempt detected. |
| 244 | FACER_ART_MASK_DETECTED |
Liveness spoofing attempt detected. |
| 245 | FACER_ELECTRONIC_DEVICE_DETECTED |
Liveness spoofing attempt detected. |
| 246 | FACER_TRACK_BREAK |
Liveness spoofing attempt detected. |
| 247 | FACER_WRONG_GEO |
Liveness spoofing attempt detected. |
| 248 | FACER_WRONG_OF |
Liveness spoofing attempt detected. |
| 249 | FACER_WRONG_VIEW |
Liveness spoofing attempt detected. |
| 250 | FACER_TIMEOUT_LIVENESS_TRANSACTION |
The user did not complete the liveness verification within the allowed time. |
| 251 | FACER_FAILED_LIVENESS_TRANSACTION |
A system error occurred during the liveness verification process. |
| 252 | FACER_ABORTED_LIVENESS_TRANSACTION |
The user aborted the liveness verification process by clicking the Close button or exiting the application. |
| 253 | FACER_GENERAL_CHECK_FAIL |
Liveness spoofing attempt detected. |
| 254 | FACER_PASSIVE_LIVENESS_FAIL |
Liveness spoofing attempt detected. |
| 255 | FACER_PRINTED_FACE_DETECTED |
Liveness spoofing attempt detected. |
| 256 | FACER_BLOCKED_REQUEST |
Request processing has been blocked. |
| 257 | FACER_CORRUPTED_REQUEST |
The request cannot be processed because data integrity was violated during transmission. |
| 258 | FACER_GENERAL_CHECK_FAIL_RTD |
Liveness spoofing attempt detected. |
| 259 | FACER_BLINK_FAILED |
Blink check failed on the backend. This error applies only to the liveness mode with blinking enabled. |
| 260 | FACER_BAD_FACE_QUALITY_LIVENESS_TRANSACTION |
The quality of the captured images is too low to perform reliable detection. The user must pass liveness verification again with better lighting, a clearer background, and a properly positioned camera. |
| 261 | FACER_BAD_FRAME_SIZE |
The frame size is below the required minimum. Liveness verification requires at least HD-quality frames. |
Note
Codes 237, 240-249, 253-255, and 258 indicate that liveness spoofing was detected at different stages of the pipeline. They are intended for debugging and do not identify the exact reason for the failed liveness check.