POST
/
liveness
얼굴 이미지에서 실시간 감지
curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/liveness \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "faceImage": "{{faceImage_base64}}"
}'
{
  "apiType": "id_live_face",
  "result": {
    "liveness_score": 95
  },
  "transactionId": "e0nvom3caiis7"
}
​
faceImage
string
required
Face image in base64 format. Base64 encoded characters in the payload must not include the MIME type. For example, if the encoded base64 characters are “image/png;base64,/9j/2wBDABQODxIP…”, then remove “image/png;base64,” and send only the encoded data “/9j/2wBDABQODxIP…”.
​
apiType
string
API type identifier for the liveness detection service.
​
result.liveness_score
number
Liveness score indicating the probability of a live person (0-100). Higher scores indicate higher confidence that the image is from a live person.
​
transactionId
string
Unique identifier for each request, useful for tracking and debugging purposes.
​
message
string
Information message returned as part of the recognition response, providing additional context about the result.
​
errorCode
number
Identifies the specific error for troubleshooting. Common error codes include:
  • 1016: faceImage is required
  • 1017: Fail to analyze face

Authorizations

​
x-api-key
string
header
required

인증 및 접근 제어 목적으로 필수적인 API 키, 권한 부여에 필요합니다.

Body

application/json

Response

200
application/json

모든 것이 예상대로 작동했습니다.

The response is of type object.