증거 세트 조회

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

요청

헤더

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

경로 매개변수

매개변수	유형	필수	설명
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는 base64로 인코딩된 PDF 묶음입니다

응답

200 OK

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

필드	유형	설명
fileContents	string (base64)	증거 묶음이며, base64로 인코딩되어 있습니다.
contentType	string	MIME 유형입니다 — 일반적으로 application/pdf입니다.

오류 코드

참고

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

400 Bad Request

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

401 Unauthorized

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

404 Not Found

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

500 Internal Server Error

코드	메시지	설명
99999	Internal failure! Try again later	내부 오류가 발생했을 때.

다음 단계

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