---
title: 常见问题
description: 关于 IDCloud 的常见问题——集成、身份验证、错误代码及支持平台。
canonical: https://developer.unico.io/zh-CN/dual-api/resources/faq
locale: zh-CN
generated_by: markdown-export
---

### HTTP 标准与请求头

## Unico 是否推荐某种 HTTP 请求头标准？

Unico 建议遵守现行 HTTP 规范（最初定义于 RFC 7230 和 RFC 7231，现已被 RFC 9110 及相关标准取代）。不符合规范的请求头可能因代理拒绝而导致集成故障，例如出现"415（不支持的媒体类型）"或"502（网关错误）"错误。

常见违规包括：`Content-Encoding` 值无效、请求头名称含有空格、重音符号或非 ASCII 字符、值中含控制字符，以及被禁止的请求头重复。发送请求前请务必验证请求头的合规性。

### 证书与安全

## Unico 是否推荐证书锁定（Certificate Pinning）？

不推荐。证书锁定在常规证书更换周期中可能导致服务不可用，其安全收益有限，且会阻断现代防护机制（CDN、WAF、攻击缓解）。Unico 通过全球公认的证书颁发机构、证书透明度公开审计以及 OAuth + JWT 等健壮认证标准来保障连接安全。

## 为什么在没有令牌的情况下无法在普通 iframe 中使用 by Unico 链接？

出于安全、可追溯性和访问控制的考量，禁止在无认证令牌的情况下直接嵌入。需要使用安全的会话令牌，该令牌按请求生成并与交易、用户及上下文绑定。

直接使用链接的风险包括：社会工程和网络钓鱼漏洞、完整性丧失、审计链断裂，以及安全策略暴露（增加枚举风险或超出请求头大小限制）。

### 数据库与处理

## 我可以将自有数据库导入由 Unico 处理吗？

可以。该流程需要：通知您的客户经理、申请服务账号、获取配置为 base64 图像（非加密）的 APIKey，并执行 API 调用同时存储响应数据和流程 ID——这对于 1:1 验证等功能至关重要。

### 性能与速率限制

## Unico 是否有 TPS/RPM 限制？

有。默认限制为每客户 10 TPS（每秒事务数），以维护平台稳定性和安全性。限制可通过合同进行调整，也可通过您的客户经理临时或永久提升。超出限制的请求将收到 `429（请求过多）` 错误。

### 集成类型

## API 与 Web & Native 集成有何区别？

**Web & Native**：Unico 按照 UX 和安全最佳实践管理完整的用户体验，提供自动 SDK 更新和转化率优化。可通过 webview、iframe 或异步消息（WhatsApp、短信、邮件）部署。

**API**：企业通过自有前端控制用户体验，同时借助 Unico 的后端能力及其他认证技术。

### 编排

## 什么是编排？

在生物特征注册过程中，当身份验证返回"不确定"时，编排会自动使用**欺诈风险分类**能力执行概率验证，以确定人脸与身份证件持有人是否匹配。

### Web & Native——部署与定制

## 如何在我的业务中使用 Web & Native？

提供三种部署方式：移动应用 webview、Web 应用 iframe 或消息流（WhatsApp、短信、邮件）。

## Web & Native 支持哪些定制？

可定制项包括：Logo、CTA 背景色、CTA 文字以及 CTA 圆角大小（单位：像素）。

### 文件技术

## 文件技术是如何工作的？

- **类型识别**：验证文件版式是否与指定类型匹配（不进行鉴伪）。
- **人脸匹配**：将用户自拍照与文件上的人脸照片进行比对（返回 true/false）。
- **CPF 匹配**：将提供的 CPF 与文件上的 CPF 进行比对（返回 true/false）。
- **OCR 提取**：将文件图像中的数据转换为文本格式。

## Unico 是否进行文件鉴伪？

不。Unico 提供类型识别、OCR 数据提取、人脸匹配和 CPF 匹配——但目前不执行文件鉴伪。

### API 特性

## 我可以手动使用 IDCloud 吗？

可以，支持手动使用。

## IDUnico API 是同步还是异步的？

两种方式均可选择。在配置 APIKey 时选择您偏好的集成方式。

## 身份验证的平均响应时间是多少？

预期延迟平均为 3 秒，但可能因产品使用方式而有所不同（例如是否使用活体检测、APIKey 是同步还是异步等因素）。

### API 响应与决策

## IDUnico API 对审批决策的返回结果是什么？

最常见的场景（身份验证 + 欺诈风险分类）返回：

```json
{
  "id": "abc-123",
  "status": 3,
  "unicoId": {
    "result": "yes"
  },
  "liveness": 1,
  "score": 87.5
}
```

### 附加功能与错误处理

## Unico 产品是否提供 Serpro 相似度？

是的。IDCloud 通过 API 和 Web & Native 均提供 Serpro 相似度功能，返回 Serpro 相似度百分比——常用于薪资贷款流程。Serpro（Serviço Federal de Processamento de Dados）是巴西联邦政府数据处理服务机构，负责维护用于比对的国家身份注册数据库。

## 最常见的错误返回有哪些？

| 代码 | 描述 |
|---|---|
| `400` | 请求错误 |
| `401` | 身份验证缺失或无效 |
| `403` | 权限错误 |
| `404` | 数据未找到 |
| `429` | 超出速率限制 |
| `500` | 服务器错误及意外故障 |

## 如果生物特征采集失败会怎样？

**Web & Native**：托管体验允许用户重试，具有较高的转化率。

**API**：错误必须作为 API 中的异常进行处理。请查阅文档获取错误代码和场景映射。