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

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

# 캡처 API

세션 시작 메서드
| 메서드 | 설명 |
| --- | --- |
| `openCameraSelfie({listener})` | 셀피 카메라 열기 |
| `openCameraSelfie({listener, prepareInfo})` | `UnicoCheckPrepareInfo` 메타데이터와 함께 셀피 카메라 열기 |
| `openCameraDocument({documentType, listener})` | 원하는 `DocumentCameraTypes`로 문서 카메라 열기 |

캡처 옵션 / 파라미터
**`UnicoCheckPrepareInfo`** — 사용자 세션을 식별하기 위한 메타데이터.

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

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

결과 타입 및 필드
**`ResultCamera`** — 캡처 성공 시 반환되는 객체 (셀피 또는 문서).

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

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