> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Face Liveness API

> 스푸핑 공격을 방지하기 위해 얼굴 이미지에서 실시간을 감지합니다

<ParamField body="faceImage" type="string" required>
  base64 형식의 얼굴 이미지. 페이로드의 base64 인코딩된 문자에는 MIME 타입을 포함하지 않아야 합니다. 예를 들어, 인코딩된 base64 문자가 "image/png;base64,/9j/2wBDABQODxIP..."인 경우 "image/png;base64,"를 제거하고 인코딩된 데이터 "/9j/2wBDABQODxIP..."만 전송하세요.
</ParamField>

<ResponseField name="apiType" type="string">
  실시간 감지 서비스의 API 타입 식별자.
</ResponseField>

<ResponseField name="result.liveness_score" type="number">
  살아있는 사람의 확률을 나타내는 실시간 점수 (0-100). 높은 점수는 이미지가 살아있는 사람으로부터 온 것일 가능성이 높음을 나타냅니다.
</ResponseField>

<ResponseField name="transactionId" type="string">
  각 요청에 대한 고유 식별자로, 추적 및 디버깅 목적으로 유용합니다.
</ResponseField>

<ResponseField name="message" type="string">
  인식 응답의 일부로 반환되는 정보 메시지로, 결과에 대한 추가 컨텍스트를 제공합니다.
</ResponseField>

<ResponseField name="errorCode" type="number">
  문제 해결을 위한 특정 오류를 식별합니다. 일반적인 오류 코드는 다음과 같습니다:

  * 1016: faceImage가 필요합니다
  * 1017: 얼굴 분석에 실패했습니다
</ResponseField>


## OpenAPI

````yaml POST /liveness
openapi: 3.1.0
info:
  title: Face Liveness API
  description: API for detecting live person verification and preventing spoofing attacks
  version: 1.0.0
servers:
  - url: https://idverify-api.argosidentity.com/modules
    description: Production server
security: []
paths:
  /liveness:
    post:
      summary: Detect liveness in facial image
      description: >-
        Analyze a facial image to determine if it was captured from a live
        person, preventing fraud attempts using fake photos, videos, or other
        spoofing techniques.
      operationId: detectLiveness
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - faceImage
              properties:
                faceImage:
                  type: string
                  description: >-
                    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...".
                  example: '{{faceImage_base64}}'
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                type: object
                properties:
                  apiType:
                    type: string
                    description: API type
                    example: id_live_face
                  result:
                    type: object
                    properties:
                      liveness_score:
                        type: number
                        description: >-
                          Liveness score indicating the probability of a live
                          person (0-100)
                        example: 95
                  transactionId:
                    type: string
                    description: Unique identifier for each request
                    example: e0nvom3caiis7
        '400':
          description: >-
            The request was unacceptable, often due to missing a required
            parameter.
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactionId:
                    type: string
                    description: >-
                      Unique identifier for the transaction associated with the
                      recognition request.
                  message:
                    type: string
                    description: >-
                      Information message returned as part of the recognition
                      response.
                  errorCode:
                    type: number
                    description: Identifies the specific error for troubleshooting.
                    enum:
                      - 1016
                      - 1017
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key essential for authentication and access control purposes,
        required for authorization.

````