---
title: 重新处理与生物识别库导入
description: 在 Unico 平台上重新处理生物识别记录或导入生物识别库的指南。
canonical: https://developer.unico.io/zh-CN/dual-api/resources/reprocessing
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- 资源
- 重新处理与生物识别库导入

**本页内容# 重新处理与生物识别库导入

本指南介绍如何在 Unico 平台上执行**重新处理**或**生物识别库导入**。内容详细说明了按照平台最佳实践进行有效、安全集成所需的技术和运营要求。
### 范围​

本材料涵盖两种类型的流程：

**重新处理**：对已经通过客户和 Unico 库的用户的生物识别记录进行重新处理，用于重新评估或系统间迁移。
**生物识别库导入**：初始上传或更新包含自拍照的库，用于身份验证和/或风险分类目的。
**文档库导入**：与自拍照一起上传文档库，用于 Facematch 或 CPF Match 验证目的（仅限巴西）。

### 前提条件​

客户**必须与 Unico 签署有效合同或保密协议**，并处于集成阶段（经治理团队批准的除外）。
项目将遵循正式的 **TPS（每秒事务数）协议**。参见下方的 [TPS 协议](#tps-agreement)。
获取生产凭证前，**必须完成完整的集成验收测试**，以确保数据质量、payload 合规性和稳定性能。
必须为重新处理或导入创建**专用服务账户**（例如 "Reprocessing" 或 "Legacy_Import"）。
将为重新处理/导入创建**专用 API Key**。
**（可选）** 可以为重新处理/导入创建专用子公司。此参数在 payload 中标识为 `subsidiaryId`。参见下方的 [Payload 参数](#payload-parameters)。
API Key 和服务账户将在约定期限到期或处理完成后**被停用**。

### 可用能力​

能力描述**身份验证**验证提交的自拍照是否属于标识符的实际持有人。**欺诈风险分类**检查与该面部相关的欺诈行为历史记录。**Facematch**验证文档照片是否与提交的自拍照匹配。**CPF Match** Brazil only验证提供的 CPF 是否与文档上印刷的 CPF 号码匹配。注意：并非所有 RG 都印有 CPF。
### 自拍照要求​

必 须以 **base64** 格式提交。
图像必须符合 **ICAO 标准**（浅色背景、面部居中、无遮挡识别的配件、适当的光照）。
推荐尺寸：**1080x1920**（竖屏）或 **1920x1080**（横屏）。
最大大小：**800 KB**（如需要请使用 JPEG 92 压缩）。
方向：**竖屏**。

### 文档要求​

**支持的文档类型**：参见[文档采集与重用 — 支持的文档](/zh-CN/capabilities/document-reuse-and-capture#supported-documents)。
图像必须包含文档的**正面和背面**，完全可见且无裁剪。
文档必须**清晰可读** — 清晰、光照良好，无遮挡。

### TPS 协议​

本项目约定的最大 TPS 为 **10 TPS**。
将请求均匀分布在时间上，而不是大批量发送。
未经 Unico 团队正式批准，**不得超过**此限制。
超过限制的请求可能会被自动丢弃或阻止。
如需临时增加，需要**事先正式协商**。

### 集成​

#### 端点​

环境基础 URL访问说明Staging`https://api.id.uat.unico.app`开放测试必需Production`https://api.id.unico.app`仅在验收通过后需要严格的 TPS 控制
#### 必需的请求头​

```
Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json
```

#### Payload 参数​

```
{  "subject": {    "duiType": 1,    "code": "11032395702",    "name": "User Name",    "email": "username@gmail.io",    "phone": "21998571922",    "birthDate": "30/07/1989",    "gender": "M"  },  "useCase": "Reprocessamento/Importação",  "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819",  "imageBase64": "/9j/4AAQSkZJR...",  "document": {    "purpose": "Reprocessamento",    "documentId": "doc-001",    "files": [      {        "data": "doc_base64_frente",        "faceDocumentMatch": true      },      {        "data": "doc_base64_verso"      }    ]  }}
```

字段类型必需描述`subject`object是用户标识数据。`subject.duiType`integer是文件类型标识符。参见下方的 [`duiType` 值](#duitype-values)。`subject.code`string是CPF 或其他用户标识符。`subject.name`string是用户全名。`subject.email`string否用户电子邮件。`subject.phone`string否用户电话号码。`subject.birthDate`string否用户出生日期（`DD/MM/YYYY`）。`subject.gender`string否用户性别（`M` 或 `F`）。`useCase`string是用例名称（"Reprocessamento" 或 "Importação de base"）。`subsidiaryId`string否子公司 UUID（由 Unico 提供）。`imageBase64`base64是用户自拍照转换为 base64 格式。`document`object否与流程关联的文件数据。`document.purpose`string否文件用途（例如，`"Reprocessamento"`）。`document.documentId`string否文件标识符。`document.files`array否文件图像列表。`document.files[].data`base64否文件图像转换为 base64 格式。`document.files[].faceDocumentMatch`boolean否指示文件中的面部是否与提交的自拍照匹配。
**`duiType` 值**国家代码描述AR6阿根廷护照AR7阿根廷 DNIAR49阿根廷驾驶证（Licencia Nacional de Conducir）AT34奥地利税号（STNR）BE36比利时国家号码（NN）BR1巴西 CPFBR5巴西护照BR14巴西 CNPJCA28加拿大 SINCH33瑞士 AHV/AVS 号码CL9智利 RUNCL52智利护照CL57智利驾驶证（Licencia de Conducir）CO26哥伦比亚 NITCO53哥伦比亚护照CO55哥伦比亚驾驶证（Licencia de Conducción）CO56哥伦比亚公民身份证（Cédula de Ciudadanía）DE41德国税务识别号码（IdNr）DK29丹麦 CPREC10厄瓜多尔 NIES50西班牙外国人身份号码（NIE）ES51西班牙国民身份证（DNI）FI35芬兰个人身份代码（HETU）FR46法国税务参考号码（SPI）GB30英国国民保险号码（NINO）GT12危地马拉 CUIID16印度尼西亚 NIKIE47爱尔兰个人公共服务号码（PPSN）IT37意大利税务代码（CF）LU48卢森堡国民身份号码（Matricule）MX2墨西哥 CURPMX25墨西哥 RFC（自然人）MX58墨西哥驾驶证（Licencia de Conducir）NG8尼日利亚 NINNG20尼日利亚银行验证号码（BVN）NG43尼日利亚 BVN 令牌（哈希）NG44尼日利亚 NIN 令牌（哈希）NL42荷兰公民服务号码（BSN）NO39挪威国民身份号码（Fødselsnummer）PE27秘鲁 RUCPE40秘鲁 DNIPE54秘鲁护照PL31波兰 PESELPT45葡萄牙税务识别号码（NIF）SE32瑞典个人号码（PNR）SE38瑞典协调号码（Samordningsnummer）TR24土耳其身份证号码（TCKN）US4美国 SSNUS11美国护照US18美国驾驶执照US21美国护照卡US22美国聚碳酸酯护照US23美国身份证UY13乌拉圭 CIZZ15电子邮件地址ZZ17电话号码—0未指定—3Unico 内部标识符
#### 重要说明​

自拍照**必须符合 ICAO 标准**，具备适当的质量和光照。
自拍照必须为 **base64 格式**。
避免在没有 TPS 控制的情况下批  量提交，这可能触发速率限制（参见下方的[错误处理](#error-handling)）。
请始终先在 staging 环境中测试数据和集成。

#### 响应​

**成功 — 200 OK**
无文档有文档（Facematch）```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "unicoId": {    "result": "inconclusive"  },  "identityFraudsters": {    "result": "inconclusive"  }}
```

字段类型描述`id`string流程标识符。请保存以备将来查询或后续实施 1:1 验证时使用。`status`integer事务状态。`unicoId.result`string身份验证能力响应。`identityFraudsters.result`string欺诈风险分类能力响应。```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "score": 0,  "status": 3,  "unicoId": {    "result": "yes"  },  "faceDocumentMatch": {    "faceMatch": true  },  "identityFraudsters": {    "result": "yes"  }}
```

字段类型描述`id`string流程标识符。请保存以备将来查询或后续实施 1:1 验证时使用。`status`integer事务状态。`score`numberFacematch 分数。`unicoId.result`string身份验证能力响应。`faceDocumentMatch.faceMatch`boolean文档照片是否与提交的自拍照匹配。`identityFraudsters.result`string欺诈风险分类能力响应。
**图像处理错误**
```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 5}
```

**常见错误**
`4xx` 范围的代码表示所提供数据的验证错误。`5xx` 范围的代码表示服务器端故障。
HTTP 代码错误类型可能原因建议操作`400`Bad Request无效的 payload验证结构和内容。`401`Unauthorizedtoken 过期或无效重新生成 token。`403`ForbiddenAPI Key 不正确或权限不足验证凭证。`429`Too Many Requests请求速率超出限制等待并遵守 TPS 限制。`500+`Internal Server Error内部故障等待几秒后重试；如持续出现请提交工单。
### 错误处理​

必须仔细监控 **Rate Limit (HTTP 429)**。请求过载可能阻塞管道。
始终遵守与 Unico 约定的 TPS（参见 [TPS 协议](#tps-agreement)）。
对于持续性故障 (5xx)，使用重试/退避控制进行重新处理。
最后更新 于 2026年10月8日**