---
title: 概要
description: Human Tokenの統合に関するステップバイステップガイド — 認証から最初のhumanTokenの取得まで。
canonical: https://developer.unico.io/ja/human-token/api-reference/overview
locale: ja
generated_by: markdown-export
---

- [/ja/](/ja/)
- APIリファレンス
- 概要

**このページの内容API Reference 概要ゼロから最初のhumanTokenを取得するまでに必要なすべて。

Human Tokenには3つのエンドポイントがあります。このページでは、それらがどのように連携するかを示し、すぐに統合を開始できるようにします。
### ベースURL​

環境ベースURL**本番環境**`https://humantoken.unico.app`
すべてのリクエストには`x-unico-accesskey`ヘッダーが必要です。キーの生成方法については[認証](/ja/human-token/get-started/authentication)をご覧ください。

### クイックスタートフロー​

### ステップ1 — 認証​

[Human Dashboard](https://dashboard.unico.app)または[Authentication API](/ja/human-token/get-started/authentication)で`x-unico-accesskey`を生成します。以下のすべてのリクエストでこのキーを使用します。
```
x-unico-accesskey: uip_ak.prod.a1b2c3d4.e5f6g7h8.i9j0k1l2
```

### ステップ2 — プロセスを作成する​

[Create Process](/ja/human-token/api-reference/post-processes)を呼び出して検証を開始します。2つのモデルから1つを選択してください：
モデルフロー仕組み**API Only**`api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation`バックエンドがセルフィーを`imageBase64`として送信します。`humanToken`は同じレスポンスで返されます。**Human Token Journey**`humantoken`, `humantoken+revalidation`ユーザーがUnicoプラットフォームでキャプチャを完了します。journeyを提示するための`token`と`link`を取得し、Get Processで結果を取得します。
**API Onlyの例：**
```
curl -X POST https://humantoken.unico.app/client/v1/process \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \  -H "Content-Type: application/json" \  -d '{    "flow": "api+humantoken",    "imageBase64": "<base64-encoded-selfie>",    "companyBranchId": "<your-branch-id>"  }'
```

**Human Token Journeyの例：**
```
curl -X POST https://humantoken.unico.app/client/v1/process \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \  -H "Content-Type: application/json" \  -d '{    "flow": "humantoken",    "callbackUri": "https://yourapp.com/callback",    "companyBranchId": "<your-branch-id>"  }'
```

すべてのフロー、パラメータ、レスポンスの詳細については[Create Process](/ja/human-token/api-reference/post-processes)をご覧ください。

### ステップ3 — ユーザーにjourneyを提示する（Journeyフローのみ）​

`humantoken`および`humantoken+revalidation`フローの場合、Create Processのレスポンスには以下が含まれます：

**`token`** — [Web SDK](/ja/human-token/integrations/web/web-integration/)またはネイティブ統合を初期化します
**`link`** — ユーザーをリダイレクトするURL

プラットフォームに合った統合を選択してください：
プラットフォームアプローチ**Web — SDK**`idpay-b2b-sdk`でjourneyをインラインで埋め込む → [Web Integration](/ja/human-token/integrations/web/web-integration/)**Web — Redirect**ユーザーを`link`にリダイレクトする → [Web Integration](/ja/human-token/integrations/web/web-integration/)**Android**Custom Tabs → [Android](/ja/human-token/integrations/app/android)**iOS**ASWebAuthenticationSession → [iOS](/ja/human-token/integrations/app/ios)**Ionic**Capacitor plugin → [Ionic](/ja/human-token/integrations/app/ionic)**React Native**Native module → [React Native](/ja/human-token/integrations/app/react-native)**Flutter**Platform Channels → [Flutter](/ja/human-token/integrations/app/flutter)
journeyが終了すると、ユーザーは`callbackUri`に戻ります。ステップ4に進んでください。
API Onlyフローこのステップをスキップしてください — 結果はすでにCreate Processのレスポンスに含まれています。

### ステップ4 — 結果を取得する（Journeyフローのみ）​

プロセス`id`を使用して[Get Process](/ja/human-token/api-reference/get-process)を呼び出し、結果を取得します：
```
curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

レスポンスには`data.humanToken.value`（標準フロー）または`data.humanTokenMatch`（再検証フロー）が含まれます。完全なレスポンススキーマとステータス値については[Get Process](/ja/human-token/api-reference/get-process)をご覧ください。

### ステップ5 — humanTokenを使用する​

`humanToken`は安定した不透明な識別子です（最大100文字）。同じ人物は常に同じ値に解決されます。
```
const { humanToken } = process.data;if (!humanToken?.value) {  // Inconclusive — retry or reject per your business rules  return;}const existing = await db.persons.findByHumanToken(humanToken.value);if (existing) {  // Same person seen before — returning user or duplicate} else {  // First time — create a new record  await db.persons.create({ humanToken: humanToken.value });}
```

警告保存または照合する前に、`data.humanToken.value`が空でないことを必ず確認してください。

### ステップ6 — セルフィーを取得する（オプション）​

[Get Selfie](/ja/human-token/api-reference/get-selfie)を呼び出してキャプチャした画像をダウンロードします。セルフィーはプロセス完了後**24時間**利用可能です — その後、完全に削除されます。
```
curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

レスポンスの詳細とエラーコードについては[Get Selfie](/ja/human-token/api-reference/get-selfie)をご覧ください。

### エンドポイント一覧​

メソッドエンドポイント説明`POST``/client/v1/process`[Create Process](/ja/human-token/api-reference/post-processes) — 検証を開始`GET``/client/v1/process/{processId}`[Get Process](/ja/human-token/api-reference/get-process) — 結果を取得`GET``/client/v1/process/{processId}/selfie`[Get Selfie](/ja/human-token/api-reference/get-selfie) — セルフィーをダウンロード（24時間）
### 次のステップ​

[Create Process](/ja/human-token/api-reference/post-processes) — 5つのフローすべての完全なパラメータリファレンス
[Authentication](/ja/human-token/get-started/authentication) — アクセスキーの生成と管理
[Build With LLM](/ja/human-token/api-reference/build-with-llm) — AIアシスタントにプロンプトを貼り付けて完全な統合を生成
最終更新 2026年10月22日**に