post https://api.verihubs.com/v1/face/compare
This method helps you to compare face between 2 images
You will receive a response consists of message and an error code if the request fails to process. The following is a list of error codes.
| Error status | Error code | Description |
|---|---|---|
| 200 | FAIL_ON_1 | fail on liveness |
| 200 | FAIL_ON_2 | fail on attribute |
| 200 | FAIL_ON_3 | fail on liveness and attribute |
| 200 | FAIL_ON_4 | fail on quality |
| 200 | FAIL_ON_5 | fail on liveness and quality |
| 200 | FAIL_ON_6 | fail on attribute and quality |
| 200 | FAIL_ON_7 | fail on liveness, attribute, and quality |
| 200 | FAIL_ON_8 | fail on number of face (nface) |
| 200 | FAIL_ON_9 | fail on number of face (nface) and liveness |
| 200 | FAIL_ON_10 | fail on number of face (nface) and attribute |
| 200 | FAIL_ON_11 | fail on number of face (nface), attribute, and liveness |
| 200 | FAIL_ON_12 | fail on number of face (nface) and quality |
| 200 | FAIL_ON_13 | fail on number of face (nface), quality, and liveness |
| 200 | FAIL_ON_14 | fail on number of face (nface), quality, and attribute |
| 200 | FAIL_ON_15 | fail on number of face (nface), quality, attribute, and liveness |
| 200 | FAIL_ON_16 | fail on similarity status |
| 400 | INVALID_PAYLOAD | no value in payload or empty string more than 1 |
| 400 | INVALID_PAYLOAD_IMAGE_1_MISSING | invalid payload image 1 not a standard b64/url or image empty string |
| 400 | INVALID_PAYLOAD_IMAGE_2_MISSING | invalid payload image 2 not a standard b64/url or image empty string |
| 400 | INVALID_PAYLOAD_IMAGE_1_SIZE | invalid payload image 1 size too large |
| 400 | INVALID_PAYLOAD_IMAGE_2_SIZE | invalid payload image 2 size too large |
| 400 | MISSING_PAYLOAD_IMAGE_1 | missing payload image 1 |
| 400 | MISSING_PAYLOAD_IMAGE_2 | missing payload image 2 |
| 400 | INVALID_PAYLOAD_IMAGE_1_TIMEOUT | timeout getting image 1 from url in 15 seconds |
| 400 | INVALID_PAYLOAD_IMAGE_2_TIMEOUT | timeout getting image 2 from url in 15 seconds |
| 400 | INVALID_PAYLOAD_IMAGE_1_FORMAT | image unable to be decoded/got from url OR invalid image 1 extension |
| 400 | INVALID_PAYLOAD_IMAGE_2_FORMAT | image unable to be decoded/got from url OR invalid image 2 extension |
| 400 | FACE_NOT_DETECTED | face not detected from image |
| 400 | INVALID_PAYLOAD_QUALITY_VALIDATION_DEPENDENCY | is_quality must be true if validate_quality true |
| 400 | INVALID_PAYLOAD_ATTRIBUTE_VALIDATION_DEPENDENCY | is_attribute must be true if validate_attribute true |
| 400 | INVALID_PAYLOAD_LIVENESS_VALIDATION_DEPENDENCY | is_liveness must be true if validate_liveness true |
| 400 | INVALID_PAYLOAD_THRESHOLD_MISSING | threshold must be basic/moderate/high |
| 403 | INSUFFICIENT_QUOTA_COMPARE | usage reach it quota limit for compare (only appears on testing mode) |
| 403 | INSUFFICIENT_QUOTA_LIVENESS | usage reach it quota limit for liveness (only appears on testing mode) |
| 500 | INTERNAL_SERVER_ERROR | internal server error |