---
title: 概要
description: 生体認証キャプチャがUnico（iFrame、リダイレクト、またはネイティブSDK）によってホストされている場合に使用します。
canonical: https://developer.unico.io/ja/dual-api/developers/api-reference/web-sdk/
locale: ja
generated_by: markdown-export
---

このセクションでは、クライアントアプリケーションがキャプチャのオーケストレーションをUnicoに委任する場合に使用する**Web & Native**コントラクトについて説明します。

## このコントラクトを使用する場合

次の場合にWeb & Nativeを使用してください：

- アプリケーションがWebリダイレクトまたは埋め込みiFrameを介して、Unicoがホストするジャーニーにユーザーを**リダイレクト**する場合。
- アプリケーションが**ネイティブSDK**（Android、iOS、またはFlutter）を使用し、キャプチャエクスペリエンスをUnicoに委任する場合。
- Webフックを介して、またはプロセス完了後に結果を取得することで、**非同期**で結果を受け取りたい場合。
- ステップの定義やエクスペリエンスのパーソナライズなど、ユーザージャーニーの**サーバーサイドカスタマイズ**がフローに必要な場合。

アプリケーションがすでに画像をキャプチャしており、直接送信したい場合は、代わりに[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リファレンス

  **プロセスの作成**

検証プロセスを作成します。Unicoがホストするキャプチャエクスペリエンス用のジャーニーURLとSDKトークンを返します。

  **プロセス結果の取得**

検証プロセスの現在の状態と結果を取得します。

  **セルフィーの取得**

検証ジャーニー中にキャプチャされたウォーターマーク付きセルフィーを取得します。

  **エビデンスセットの取得**

プロセスの完全なキャプチャエビデンスバンドルを取得します — コンプライアンスおよび規制上の監査に使用されます。

## クライアントインテグレーション

  **Webインテグレーション**

クライアントサイドでの統合方法 — リダイレクトフローとiFrame SDKのセットアップ。

  **モバイルSDK**

モバイルアプリケーション内でキャプチャエクスペリエンスを管理するためのAndroid、iOS、Flutter向けネイティブライブラリ。

## 主な特徴

| 項目 | 詳細 |
|---|---|
| **メインエンドポイント** | `POST /client/v1/process` |
| **作成時の画像** | 送信しない — Unicoがホストするジャーニー内でキャプチャされる |
| **識別情報** | 文書タイプと番号はプロセス作成時に提供 |
| **パイプライン** | プロセス作成時に選択したフロータイプによって決定 |
| **戻り値** | ネイティブSDK用のジャーニーURLとトークン |
| **結果** | 非同期 — Webフックまたは結果エンドポイントのポーリングによる |
| **認証** | OAuth2 Bearerトークン |
| **対応国** | BR、MX、AR、ID、NG、US |