概览
本节记录了 API 合同(内部称为 TCA / Check.Integration),适用于客户端应用程序自行完成采集步骤并将图像直接发送到平台的场景。
何时使用此合同
在以下情况下使用 API 合同:
- 您的应用程序已完成自拍或图像的采集(通过 Unico 原生 SDK 或专有技术栈——采集标准)。
- 您希望在流程创建响应中获得同步结果。
- 您不希望将用户重定向至托管流程。
- 您的架构偏向传统的服务器到服务器调用(请求 → 包含结果的响应)。
如果您希望由 Unico 托管流程,请改用 Web & SDK。
API 参考
客户端集成
与 Web & SDK 的区别
| 方面 | API | Web & SDK |
|---|---|---|
| 流程创建时机 | 采集后 | 采集前 |
| 图像返回 | 即时(客户端采集后) | 通过专用端点 |
| 流程控制 | 客户端 | Unico |
| 采集控制 | 客户端(使用或不使用 SDK) | Unico |
| 身份标识 | subject.code | person.duiType + person.duiValue |
| 请求头 | Authorization + APIKEY | 仅 Authorization |
| 结果结构 | 扁平(unicoId.result、liveness 等) | 嵌套(process.authenticationInfo.*Result) |

