개요

이 섹션은 클라이언트 애플리케이션이 캡처 단계를 담당하고 플랫폼에 직접 이미지를 전송하는 경우 사용되는 API 계약(내부적으로 TCA / Check.Integration이라고 함)을 문서화합니다.

이 계약을 사용하는 경우

다음의 경우 API 계약을 사용하세요:

애플리케이션이 이미 셀피 또는 이미지를 캡처한 경우(Unico의 네이티브 SDK 또는 독자적인 스택 — Capture Standard 사용).
프로세스 생성 응답 자체에서 동기적 결과를 원하는 경우.
사용자를 호스팅된 여정으로 리디렉션하고 싶지 않은 경우.
아키텍처가 전통적인 서버 간 호출(요청 → 결과를 포함한 응답)을 선호하는 경우.

Unico가 여정을 호스팅하도록 하려면 Web & SDK를 사용하세요.

API 레퍼런스

프로세스 생성

캡처된 이미지를 직접 전송하여 검증 프로세스를 생성합니다. 동기적 결과를 반환합니다.

프로세스 조회

식별자로 기존 API 계약 프로세스를 검색합니다.

재사용 가능한 문서 조회

새 캡처 흐름을 시작하기 전에 사용자가 재사용 가능한 문서를 이미 보유하고 있는지 확인합니다.

문서 프로세스 생성

새 문서를 캡처하거나 생체 인식 프로세스와 연결된 이전에 캡처된 문서를 재사용합니다.

데이터 검증

주어진 CPF에 대한 등록 데이터, PEP/AML 심사 및 스포츠 관계를 조회합니다.

클라이언트 통합

네이티브 SDK

모바일 애플리케이션 내에서 셀피를 캡처하기 위한 Android, iOS 및 Flutter용 네이티브 라이브러리.

캡처 표준

Unico의 SDK를 사용하지 않을 때 독자적인 캡처가 충족해야 하는 기술 요구 사항 — 해상도, 형식, 조명 등.

측면	API	Web & SDK
프로세스 생성 시점	캡처 후	캡처 전
이미지 반환	즉시 (클라이언트 측 캡처 후)	전용 엔드포인트를 통해
여정 제어	클라이언트	Unico
캡처 제어	클라이언트 (SDK 사용 여부와 무관)	Unico
식별	`subject.code`	`person.duiType` + `person.duiValue`
헤더	`Authorization` + `APIKEY`	`Authorization`만
결과 스키마	플랫 (`unicoId.result`, `liveness` 등)	중첩 (`process.authenticationInfo.*Result`)