셀피 조회
사용자가 Unico가 호스팅하는 여정 중에 캡처한 생체 인식 셀피를 반환합니다. 이미지는 워터마크가 적용된 base64로 인코딩된 문자열로 반환됩니다.
생체 인식 캡처를 수행한 모든 완료된 프로세스에서 사용할 수 있으며, 스마트 재검증(idsmart) 여정도 포함됩니다. 생체 인식 캡처 없이 완료된 프로세스(예: 무음 인증)에서는 반환할 셀피가 없으므로 사용할 수 없습니다.
엔드포인트
| 환경 | URL |
|---|---|
| 프로덕션 | GET https://api.idcloud.unico.app/client/v1/process/{processId}/selfie |
| 샌드박스 | GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/selfie |
요청
헤더
| 헤더 | 값 |
|---|---|
Authorization | Bearer <access_token>(인증 참조) |
경로 매개변수
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
processId | string (UUID) | 예 | 프로세스 생성에서 반환된 프로세스 식별자입니다. |
예제
- cURL
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \
-H "Authorization: Bearer $TOKEN"
import fetch from 'node-fetch';
const res = await fetch(
`https://api.idcloud.unico.app/client/v1/process/${processId}/selfie`,
{ headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents는 base64로 인코딩된 이미지 문자열입니다