메인 콘텐츠로 건너뛰기
콜백 응답 예시 섹션은 API 연동 시 받게 될 응답 샘플을 보여 주어 응답 구조와 형식을 명확히 이해할 수 있게 합니다. 이 예시를 활용하면 연동을 효과적으로 개발·테스트하고, 애플리케이션과 API 간 통신을 원활하게 만들 수 있습니다. 이 섹션은 연동 과정을 개선하고 개발 작업을 간소화하는 데 유용한 자료입니다.

응답 예시

응답 필드 설명

성공 응답 필드

오류 응답 필드

오류 코드

라이브니스 점수 이해하기

점수 범위

  • 0-30: 위조 위험 높음
  • 31-60: 위조 위험 중간
  • 61-80: 위조 위험 낮음
  • 81-100: 위조 위험 매우 낮음

파이프라인 설명

Screen Replay 감지

제출된 이미지가 실물 신분증이 아니라 화면 캡처나 디지털 복제본인지 감지합니다.

Paper Printed 감지

신분증이 원본이 아니라 인쇄본이나 복사본인지 식별합니다.

Replace Portraits 감지

신분증의 얼굴 사진이 디지털로 변조되거나 교체되었는지 확인합니다.

연동 가이드

응답 처리

  1. 상태 코드 확인: 항상 응답 상태 코드를 먼저 확인합니다
  2. 트랜잭션 ID 저장: 참조용으로 트랜잭션 ID를 저장합니다
  3. 점수 평가: 파이프라인별 라이브니스 점수를 검토합니다
  4. 오류 처리: 실패한 요청에 대한 오류 처리를 구현합니다

모범 사례

  • 로그 기록: 디버깅을 위해 모든 응답을 로그로 남깁니다
  • 재시도 로직: 일시적인 실패에 대비해 재시도 로직을 구현합니다
  • 검증: 처리 전에 응답 구조를 검증합니다
  • 보안: 민감한 신분증 데이터를 안전하게 처리합니다

관련 문서

ID 라이브니스 개요

문서 진위성 감지를 위한 ID 라이브니스 API에 대해 알아보기

ID Liveness API

ID 문서의 진위 여부를 확인하기 위해 이미지를 분석하여 변조나 위조 여부를 검증합니다