메인 콘텐츠로 건너뛰기
POST
/
liveness
Detect liveness in facial image
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
필수
base64 형식의 얼굴 이미지. 페이로드의 base64 인코딩된 문자에는 MIME 타입을 포함하지 않아야 합니다. 예를 들어, 인코딩된 base64 문자가 “image/png;base64,/9j/2wBDABQODxIP…”인 경우 “image/png;base64,“를 제거하고 인코딩된 데이터 “/9j/2wBDABQODxIP…”만 전송하세요.
​
apiType
string
실시간 감지 서비스의 API 타입 식별자.
​
result.liveness_score
number
살아있는 사람의 확률을 나타내는 실시간 점수 (0-100). 높은 점수는 이미지가 살아있는 사람으로부터 온 것일 가능성이 높음을 나타냅니다.
​
transactionId
string
각 요청에 대한 고유 식별자로, 추적 및 디버깅 목적으로 유용합니다.
​
message
string
인식 응답의 일부로 반환되는 정보 메시지로, 결과에 대한 추가 컨텍스트를 제공합니다.
​
errorCode
number
문제 해결을 위한 특정 오류를 식별합니다. 일반적인 오류 코드는 다음과 같습니다:
  • 1016: faceImage가 필요합니다
  • 1017: 얼굴 분석에 실패했습니다

인증

​
x-api-key
string
header
필수

API key essential for authentication and access control purposes, required for authorization.

본문

application/json
​
faceImage
string
필수

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...".

예시:

"{{faceImage_base64}}"

응답

Everything worked as expected.

​
apiType
string

API type

예시:

"id_live_face"

​
result
object
​
transactionId
string

Unique identifier for each request

예시:

"e0nvom3caiis7"