获取自拍照

返回用户在 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 token 缺失、已过期或无效。参见身份验证。

403 Forbidden

权限不足，无法访问此流程的自拍照。

404 Not Found

未找到该流程，或该流程不提供自拍照（例如 Smart Revalidation 流程）。

错误代码

备注

该端点不提供具体的 code 或 message 值。

400 Bad Request

此状态没有记录具体的 code 或 message 值。

401 Unauthorized

此状态没有记录具体的 code 或 message 值。

403 Forbidden

此状态没有记录具体的 code 或 message 值。

404 Not Found

此状态没有记录具体的 code 或 message 值。

下一步

• 查看完整流程结果，请参见获取流程。
• 查看证据审计包，请参见获取证据集。