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

- [/zh-CN/](/zh-CN/)
- 资源
- 常见问题

**本页内容# 常见问题

### 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 对审批决策的返回结果是什么？
最常见的场景（身份验证 + 欺诈风险分类）返回：
```
{  "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 中的异常进行处理。请查阅文档获取错误代码和场景映射。最后更新 于 2026年10月8日**