증거 세트 가져오기

MarkdownChatGPTClaude

생체 캡처 중 생성된 증거 번들을 반환합니다 — 통제된 조건에서 활성 감지가 수행되었음을 증명하는 데 사용되는 캡처된 이미지, 메타데이터 및 캡처 산출물이 포함된 패키지입니다.

완료된 프로세스(state = PROCESS_STATE_FINISHED)에만 사용 가능합니다.

엔드포인트

환경	URL
프로덕션	GET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset
샌드박스	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset

요청

Headers

헤더	값
Authorization	Bearer <access_token> (인증 참조)

Path parameters

파라미터	타입	필수 여부	설명
processId	string (UUID)	예	프로세스 생성에서 반환된 프로세스 식별자.

예제

cURL

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

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded PDF bundle

응답

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

필드	타입	설명
fileContents	string (base64)	base64로 인코딩된 증거 번들.
contentType	string	MIME 타입 — 일반적으로 application/pdf.

오류 코드

참고

이 엔드포인트에 대한 특정 code 또는 message 값은 API에서 노출되지 않습니다.

400 Bad Request

processId 경로 파라미터가 누락되었거나 잘못된 형식입니다. 아래 오류 코드를 참조하세요.

401 Unauthorized

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

404 Not Found

프로세스를 찾을 수 없거나 증거 세트를 아직 사용할 수 없습니다(프로세스가 완료되지 않음).

500 Internal Server Error

코드	메시지	설명
99999	Internal failure! Try again later	내부 오류가 발생한 경우.

다음 단계

• 전체 프로세스 결과는 프로세스 가져오기를 참조하세요.
• 캡처된 셀피 이미지는 셀피 가져오기를 참조하세요.