셀피 조회

Unico 호스팅 여정 중 사용자가 캡처한 생체 인식 셀피를 반환합니다. 이미지는 워터마크가 적용된 base64 인코딩 문자열로 반환됩니다.

라이브니스 또는 신원 인증을 포함하는 생체 인식 캡처를 실행한 프로세스에 대해서만 사용 가능합니다. Smart Revalidation 플로우(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 is a base64-encoded image string

응답

200 OK

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

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

400 Bad Request

processId 경로 파라미터가 없거나 잘못된 형식입니다.

401 Unauthorized

Bearer 토큰이 없거나, 만료되었거나, 유효하지 않습니다. 인증을 참조하세요.

403 Forbidden

이 프로세스의 셀피에 접근할 권한이 없습니다.

404 Not Found

프로세스를 찾을 수 없거나, 해당 프로세스에 대해 셀피를 사용할 수 없습니다 (예: Smart Revalidation 플로우).

오류 코드

참고

이 엔드포인트에 대해 API는 특정 code 또는 message 값을 노출하지 않습니다.

400 Bad Request

이 상태에 대한 특정 code 또는 message 값이 문서화되어 있지 않습니다.

401 Unauthorized

이 상태에 대한 특정 code 또는 message 값이 문서화되어 있지 않습니다.

403 Forbidden

이 상태에 대한 특정 code 또는 message 값이 문서화되어 있지 않습니다.

404 Not Found

이 상태에 대한 특정 code 또는 message 값이 문서화되어 있지 않습니다.

다음 단계

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