증거 세트 가져오기

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

완료된 프로세스(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.

400 Bad Request

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

401 Unauthorized

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

404 Not Found

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

오류 코드

참고

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

400 Bad Request

이 상태에 대해 문서화된 특정 code 또는 message 값이 없습니다.

401 Unauthorized

이 상태에 대해 문서화된 특정 code 또는 message 값이 없습니다.

404 Not Found

이 상태에 대해 문서화된 특정 code 또는 message 값이 없습니다.

500 Internal Server Error

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

다음 단계

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