---
title: 概要
description: API 契約 — クライアントがキャプチャを制御し、リクエストに画像を直接送信する場合に使用します。
canonical: https://developer.unico.io/ja/dual-api/developers/api-reference/api/
locale: ja
generated_by: markdown-export
---

このセクションでは、**API** 契約について説明します。クライアントアプリケーションがキャプチャ手順を担い、プラットフォームに直接画像を送信する場合に使用されます。

## この契約を使用するタイミング

API 契約は以下の場合に使用します：

- アプリケーションが（Unico のネイティブ SDK または独自スタック — [キャプチャ標準](/developers/sdks-and-tools/capture-standard)を使用して）**すでにセルフィーや画像をキャプチャしている**場合。
- プロセス作成レスポンス自体で**同期結果**を取得したい場合。
- ユーザーをホスト型ジャーニーにリダイレクトしたく**ない**場合。
- アーキテクチャが従来のサーバー間呼び出し（リクエスト → 結果付きレスポンス）を好む場合。

Unico にジャーニーをホストさせたい場合は、代わりに [Web & SDK](../web-sdk) を使用してください。

## API リファレンス

  **プロセスの作成**

キャプチャした画像を直接送信することで認証プロセスを作成します。同期結果を返します。

  **プロセスの取得**

識別子によって既存の API 契約プロセスを取得します。

  **再利用可能なドキュメントの取得**

新しいキャプチャフローを開始する前に、ユーザーが再利用可能なドキュメントをすでに保有しているか確認します。

  **ドキュメントプロセスの作成**

新しいドキュメントをキャプチャするか、生体認証プロセスにリンクされた以前にキャプチャされたドキュメントを再利用します。

  **データ検証**

指定された CPF の登録データ、PEP/AML スクリーニング、スポーツ関係を照会します。

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

  **ネイティブ 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) — 完全なオンボーディング契約。
- [エラーコード](../error-codes) — 4xx および 5xx レスポンスの処理。