셀피 조회

MarkdownChatGPTClaude

사용자가 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

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "Authorization: Bearer $TOKEN"

Node.js

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로 인코딩된 이미지 문자열입니다

응답

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

필드	유형	설명
fileContents	string (base64)	캡처된 셀피이며, base64로 인코딩되어 있습니다. 워터마크가 포함되어 있습니다.
contentType	string	이미지의 MIME 유형입니다 — image/jpeg 또는 image/png.

오류 코드

참고

이 엔드포인트는 API에서 특정 code 또는 message 값을 제공하지 않습니다.

400 Bad Request

processId 경로 매개변수가 누락되었거나 형식이 올바르지 않습니다.

401 Unauthorized

Bearer 토큰이 누락, 만료, 또는 유효하지 않습니다. 인증을 참조하세요.

403 Forbidden

이 프로세스의 셀피에 접근할 권한이 부족합니다.

404 Not Found

프로세스를 찾을 수 없거나, 생체 인식 캡처 없이 프로세스가 완료되어 반환할 셀피가 없습니다.

다음 단계

• 전체 프로세스 결과는 프로세스 조회를 참조하세요.
• 증거 감사 묶음은 증거 세트 조회를 참조하세요.