---
title: 개요
description: API 계약 — 클라이언트가 캡처를 제어하고 요청에 직접 이미지를 전송하는 경우 사용합니다.
canonical: https://developer.unico.io/ko/dual-api/developers/api-reference/api/
locale: ko
generated_by: markdown-export
---

이 섹션은 클라이언트 애플리케이션이 캡처 단계를 담당하고 플랫폼에 직접 이미지를 전송하는 경우 사용되는 **API** 계약을 문서화합니다.

## 이 계약을 사용하는 경우

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

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

Unico가 여정을 호스팅하도록 하려면 [Web & SDK](../web-sdk)를 사용하세요.

## API 레퍼런스

  **프로세스 생성**

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

  **프로세스 조회**

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

  **재사용 가능한 문서 조회**

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

  **문서 프로세스 생성**

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

  **데이터 검증**

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

## 클라이언트 통합

  **네이티브 SDK**

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

  **캡처 표준**

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

### Web & SDK와의 차이점

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

### 다음 단계

- [프로세스 생성](./post-processes) — 전체 온보딩 계약.
- [오류 코드](../error-codes) — 4xx 및 5xx 응답 처리.