---
title: 概览
description: API 合同——当客户端控制采集并直接在请求中发送图像时使用。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/api-reference/api/
locale: zh-CN
generated_by: markdown-export
---

本节记录了 **API** 合同，适用于客户端应用程序自行完成采集步骤并将图像直接发送到平台的场景。

## 何时使用此合同

在以下情况下使用 API 合同：

- 您的应用程序**已完成**自拍或图像的采集（通过 Unico 原生 SDK 或专有技术栈——[采集标准](/developers/sdks-and-tools/capture-standard)）。
- 您希望在流程创建响应中获得**同步结果**。
- 您**不希望**将用户重定向至托管流程。
- 您的架构偏向传统的服务器到服务器调用（请求 → 包含结果的响应）。

如果您希望由 Unico 托管流程，请改用 [Web & SDK](../web-sdk)。

## API 参考

  **创建流程**

通过直接发送采集的图像来创建验证流程。返回同步结果。

  **获取流程**

通过标识符检索现有的 API 合同流程。

  **获取可复用文档**

在启动新的采集流程之前，检查用户是否已有可复用的在档文档。

  **创建文档流程**

采集新文档，或复用与生物特征流程关联的已采集文档。

  **数据核查**

查询给定 CPF 的登记数据、PEP/反洗钱筛查及体育关系。

## 客户端集成

  **原生 SDK**

适用于 Android、iOS 和 Flutter 的原生库，可在您的移动应用程序中采集自拍。

  **采集标准**

在不使用 Unico SDK 时，您的专有采集必须满足的技术要求——分辨率、格式、光照等。

### 与 Web & SDK 的区别

| 方面 | API | Web & SDK |
|---|---|---|
| **流程创建时机** | 采集后 | 采集前 |
| **图像返回** | 即时（客户端采集后）| 通过专用端点 |
| **流程控制** | 客户端 | Unico |
| **采集控制** | 客户端（使用或不使用 SDK）| Unico |
| **身份标识** | `subject.code` | `person.duiType` + `person.duiValue` |
| **请求头** | `Authorization` + `APIKEY` | 仅 `Authorization` |
| **结果结构** | 扁平（`unicoId.result`、`liveness` 等）| 嵌套（`process.authenticationInfo.*Result`）|

### 下一步

- [创建流程](./post-processes) — 完整的 Onboarding 合同。
- [错误代码](../error-codes) — 处理 4xx 和 5xx 响应。