获取证据集

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 is a base64-encoded PDF bundle

响应

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 token 缺失、已过期或无效。请参阅身份验证。

404 Not Found

流程未找到，或证据集尚未可用（流程未完成）。

500 Internal Server Error

代码	消息	描述
99999	Internal failure! Try again later	发生内部错误时。

后续步骤

• 有关完整的流程结果，请参阅获取流程。
• 有关采集的自拍图像，请参阅获取自拍。