응답 예시
응답 필드 설명
성공 응답 필드
오류 응답 필드
오류 코드
라이브니스 점수 이해하기
점수 범위
- 0-30: 위조 위험 높음
- 31-60: 위조 위험 중간
- 61-80: 위조 위험 낮음
- 81-100: 위조 위험 매우 낮음
파이프라인 설명
Screen Replay 감지
제출된 이미지가 실물 신분증이 아니라 화면 캡처나 디지털 복제본인지 감지합니다.Paper Printed 감지
신분증이 원본이 아니라 인쇄본이나 복사본인지 식별합니다.Replace Portraits 감지
신분증의 얼굴 사진이 디지털로 변조되거나 교체되었는지 확인합니다.연동 가이드
응답 처리
- 상태 코드 확인: 항상 응답 상태 코드를 먼저 확인합니다
- 트랜잭션 ID 저장: 참조용으로 트랜잭션 ID를 저장합니다
- 점수 평가: 파이프라인별 라이브니스 점수를 검토합니다
- 오류 처리: 실패한 요청에 대한 오류 처리를 구현합니다
모범 사례
- 로그 기록: 디버깅을 위해 모든 응답을 로그로 남깁니다
- 재시도 로직: 일시적인 실패에 대비해 재시도 로직을 구현합니다
- 검증: 처리 전에 응답 구조를 검증합니다
- 보안: 민감한 신분증 데이터를 안전하게 처리합니다
관련 문서
ID 라이브니스 개요
문서 진위성 감지를 위한 ID 라이브니스 API에 대해 알아보기
ID Liveness API
ID 문서의 진위 여부를 확인하기 위해 이미지를 분석하여 변조나 위조 여부를 검증합니다