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

- [/ko/](/ko/)
- [SDK 및 도구](/ko/developers/sdks-and-tools/overview)
- [iOS SDK](/ko/developers/sdks-and-tools/ios/requirements)
- API 레퍼런스
- 캡처 API

# 캡처 API

세션 시작 메서드
| 메서드 | 설명 |
| --- | --- |
| `prepareSelfieCamera(_:config:)` | 셀피 카메라 준비 |
| `prepareSelfieCamera(_:config:prepareInfo:)` | `PrepareInfo` 메타데이터를 사용하여 셀피 카메라 준비 |
| `prepareDocumentCamera(_:config:)` | 문서 카메라 준비 |
| `open(_:webAppToken:)` | 준비된 셀피 카메라를 열고, Create Process에서 반환된 `process.webAppToken`을 전달합니다 |
| `openDocument(_:delegate:)` | `DocumentEnums`를 사용하여 준비된 문서 카메라 열기 |

캡처 옵션 / 매개변수
**`PrepareInfo`** — 사용자 세션을 식별하기 위한 메타데이터.

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

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

결과 타입 및 필드
**`SelfieResult`** — 셀피 캡처 성공 시 반환되는 객체.

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

**`SuccessResult`** — Unico API 통합에서 `onSuccess`가 반환하는 객체.

| 필드 | 타입 | 설명 |
| --- | --- | --- |
| `processId` | `String` | REST API를 통해 검증 결과를 조회하는 데 사용되는 프로세스 식별자 |

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

마지막 업데이트 **2026년 10월 15일**에