---
title: 캡처 API
canonical: https://developer.unico.io/ko/dual-api/developers/sdks-and-tools/ios/api-reference/capture-api
locale: ko
generated_by: markdown-export
---

## 세션 시작 메서드

| 메서드 | 설명 |
|---|---|
| `prepareSelfieCamera(_:config:)` | 셀피 카메라 준비 |
| `prepareSelfieCamera(_:config:prepareInfo:)` | `PrepareInfo` 메타데이터를 사용하여 셀피 카메라 준비 |
| `prepareDocumentCamera(_:config:)` | 문서 카메라 준비 |
| `open(_:)` | 준비된 셀피 카메라 열기 |
| `open(_:webAppToken:)` | User Journey를 위해 셀피 카메라를 엽니다. journey 토큰을 전달합니다 |
| `openDocument(_:delegate:)` | `DocumentEnums`를 사용하여 준비된 문서 카메라 열기 |

## 캡처 옵션 / 매개변수

**`PrepareInfo`** — 사용자 세션을 식별하기 위한 메타데이터.

| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| `externalUserId` | `String` | 예 | 시스템 내 사용자 식별자. 전송 전 SHA-256으로 해시 처리됩니다. |
| `useCase` | `String` | 아니오 | 현재 실행 중인 컨텍스트 또는 플로우 식별자. 평문으로 전송됩니다. |

**`DocumentEnums`** — [Enums](/developers/sdks-and-tools/ios/api-reference/enums) 참조.

## 결과 타입 및 필드

**`SelfieResult`** — 셀피 캡처 성공 시 반환되는 객체.

| 필드 | 타입 | 설명 |
|---|---|---|
| `base64` | `String` | Base64로 인코딩된 캡처 이미지 |
| `encrypted` | `String` | 백엔드로 전송할 JWT |

**`DocumentResult`** — 문서 캡처 성공 시 반환되는 객체. `SelfieResult`와 동일한 필드를 가집니다.