---
title: 概述
description: 适用于生物特征采集由 Unico 托管（iFrame、重定向或原生 SDK）的场景。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/api-reference/web-sdk/
locale: zh-CN
generated_by: markdown-export
---

本节记录 **Web & Native** 接口合约，适用于客户端应用程序将采集编排委托给 Unico 的场景。

## 适用场景

在以下情况下使用 Web & Native：

- 您的应用程序通过 Web 重定向或嵌入式 iFrame 将用户**重定向**到 Unico 托管的流程。
- 您的应用程序使用**原生 SDK**（Android、iOS 或 Flutter），并将采集体验委托给 Unico。
- 您希望通过 webhook 或在完成后轮询流程结果来**异步**接收结果。
- 该流程需要**服务端自定义**用户旅程，例如定义步骤或个性化体验。

如果您的应用程序已采集图像并希望直接发送，请改用 [API](../api)。

## 流程工作方式

```mermaid
sequenceDiagram
    actor User
    participant Application
    participant Identity
    participant API as Unico Web

    User->>Application: Access your application
    Application->>Identity: Authenticate using the service account
    Identity-->>Application: Obtain the access-token
    Application->>API: POST request in Unico Web
    Note over Application,API: Send access-token + flow in request
    API-->>Application: Returns link to complete the journey
    Application-->>User: Render the link to user
    Note over User,Application: Render the link in your app<br/>or use Unico's messages

    User->>API: Makes the journey with Unico
    API-->>Application: Notify your service by Webhook or Callback
    Application->>API: GET request in Unico Web
    API-->>Application: Process response

    Note over Application: Take the decision
    Application-->>User: Feedback
```

## API 参考

  **创建流程**

创建一个验证流程。返回旅程 URL 和 SDK 令牌，用于 Unico 托管的采集体验。

  **获取流程结果**

检索验证流程的当前状态和结果。

  **获取自拍照**

检索在验证流程中拍摄的带水印自拍照。

  **获取证据集**

检索流程的完整采集证据包——用于合规和监管审计。

## 客户端集成

  **Web 集成**

如何在客户端进行集成——重定向流程和 iFrame SDK 设置。

  **移动端 SDK**

适用于 Android、iOS 和 Flutter 的原生库，用于在您的移动应用程序中管理采集体验。

## 关键特性

| 方面 | 详情 |
|---|---|
| **主要端点** | `POST /v1/process` |
| **创建时的图像** | 不发送——在 Unico 托管的流程中采集 |
| **身份识别** | 在创建流程时提供文件类型和编号 |
| **流水线** | 由创建流程时选择的流程类型定义 |
| **返回值** | 旅程 URL 和原生 SDK 的令牌 |
| **结果** | 异步——通过 webhook 或轮询结果端点 |
| **认证** | OAuth2 Bearer token |
| **支持的国家/地区** | BR、MX、AR、ID、NG、US |