---
title: 개요
description: Unico가 생체 인식 캡처를 호스팅하는 경우(iFrame, 리다이렉트 또는 네이티브 SDK)에 사용됩니다.
canonical: https://developer.unico.io/ko/dual-api/developers/api-reference/web-sdk/
locale: ko
generated_by: markdown-export
---

이 섹션은 클라이언트 애플리케이션이 캡처 오케스트레이션을 Unico에 위임하는 경우에 사용되는 **Web & Native** 계약을 문서화합니다.

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

다음과 같은 경우 Web & Native를 사용하세요:

- 애플리케이션이 웹 리다이렉트 또는 내장 iFrame을 통해 Unico 호스팅 여정으로 사용자를 **리다이렉트**하는 경우.
- 애플리케이션이 **네이티브 SDK**(Android, iOS 또는 Flutter)를 사용하고 캡처 경험을 Unico에 위임하는 경우.
- 웹훅을 통해 또는 완료 후 프로세스 결과를 가져옴으로써 결과를 **비동기적으로** 수신하고 싶은 경우.
- 플로우에 **서버 측 사용자 여정 커스터마이징**이 필요한 경우 (예: 단계 정의 또는 경험 개인화).

이미지를 직접 캡처하여 전송하려는 경우에는 [API](../api)를 사용하세요.

## 플로우 작동 방식

```mermaid
sequenceDiagram
    actor User
    participant Application
    participant Identity
    participant API as Unico Web

    User->>Application: Access your application
    Application->>Identity: Authenticate using the service account
    Identity-->>Application: Obtain the access-token
    Application->>API: POST request in Unico Web
    Note over Application,API: Send access-token + flow in request
    API-->>Application: Returns link to complete the journey
    Application-->>User: Render the link to user
    Note over User,Application: Render the link in your app<br/>or use Unico's messages

    User->>API: Makes the journey with Unico
    API-->>Application: Notify your service by Webhook or Callback
    Application->>API: GET request in Unico Web
    API-->>Application: Process response

    Note over Application: Take the decision
    Application-->>User: Feedback
```

## API 참조

  **프로세스 생성**

검증 프로세스를 생성합니다. Unico 호스팅 캡처 경험을 위한 여정 URL과 SDK 토큰을 반환합니다.

  **프로세스 결과 조회**

검증 프로세스의 현재 상태와 결과를 조회합니다.

  **셀피 조회**

검증 여정 중에 캡처된 워터마크가 적용된 셀피를 조회합니다.

  **증거 세트 조회**

프로세스의 전체 캡처 증거 번들을 조회합니다 — 컴플라이언스 및 규제 감사에 사용됩니다.

## 클라이언트 통합

  **웹 통합**

클라이언트 측 통합 방법 — 리다이렉트 플로우 및 iFrame SDK 설정.

  **모바일 SDK**

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

## 주요 특성

| 항목 | 세부 사항 |
|---|---|
| **주요 엔드포인트** | `POST /client/v1/process` |
| **생성 시 이미지** | 전송하지 않음 — Unico 호스팅 여정 내에서 캡처됨 |
| **식별** | 프로세스 생성 시 문서 유형 및 번호 제공 |
| **파이프라인** | 프로세스 생성 시 선택한 플로우 유형에 의해 정의됨 |
| **반환** | 여정 URL 및 네이티브 SDK용 토큰 |
| **결과** | 비동기 — 웹훅 또는 결과 엔드포인트 폴링을 통해 |
| **인증** | OAuth2 Bearer 토큰 |
| **지원 국가** | BR, MX, AR, ID, NG, US |