获取自拍照
返回用户在 Unico 托管流程中拍摄的生物特征自拍照。图像以 base64 编码字符串形式返回，并附带水印。
适用于任何执行了生物特征采集的已完成流程，包括智能重新验证流程（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
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \
-H "Authorization: Bearer $TOKEN"
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。 |
错误代码
备注
该端点不提供具体的 code 或 message 值。
- 400 Bad Request
- 401 Unauthorized
- 403 Forbidden
- 404 Not Found
processId 路径参数缺失或格式错误。
Bearer token 缺失、已过期或无效。参见身份验证。
权限不足，无法访问此流程的自拍照。
未找到该流程，或该流程在未进行生物特征采集的情况下即已结束，因此没有可返回的自拍照。