---
title: Обзор
description: Пошаговое руководство по интеграции Human Token — от аутентификации до получения вашего первого humanToken.
canonical: https://developer.unico.io/ru/human-token/api-reference/overview
locale: ru
generated_by: markdown-export
---

- [/ru/](/ru/)
- Справочник API
- Обзор

**На этой страницеОбзор API ReferenceВсё, что нужно, чтобы пройти путь от нуля до первого humanToken.

Human Token имеет три эндпоинта. На этой странице показано, как они взаимодействуют, чтобы вы могли сразу приступить к интеграции.
### Базовый URL​

СредаБазовый URL**Продакшен**`https://humantoken.unico.app`
Все запросы требуют заголовок `x-unico-accesskey`. См. [Аутентификация](/ru/human-token/get-started/authentication), чтобы сгенерировать ключ.

### Быстрый старт​

### Шаг 1 — Аутентификация​

Сгенерируйте `x-unico-accesskey` в [Human Dashboard](https://dashboard.unico.app) или через [Authentication API](/ru/human-token/get-started/authentication). Все запросы ниже используют этот ключ.
```
x-unico-accesskey: uip_ak.prod.a1b2c3d4.e5f6g7h8.i9j0k1l2
```

### Шаг 2 — Создать процесс​

Вызовите [Create Process](/ru/human-token/api-reference/post-processes), чтобы начать верификацию. Выберите одну из двух моделей:
МодельПотокиКак это работает**API Only**`api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation`Ваш бэкенд отправляет селфи как `imageBase64`. `humanToken` возвращается в том же ответе.**Human Token Journey**`humantoken`, `humantoken+revalidation`Пользователь завершает захват на платформе Unico. Вы получаете `token` и `link` для показа journey, затем получаете результат через 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](/ru/human-token/api-reference/post-processes) для описания всех потоков, параметров и деталей ответа.

### Шаг 3 — Показать journey пользователю (только потоки Journey)​

Для потоков `humantoken` и `humantoken+revalidation` ответ Create Process включает:

**`token`** — инициализирует [Web SDK](/ru/human-token/integrations/web/web-integration/) или нативную интеграцию
**`link`** — URL для перенаправления пользователя

Выберите интеграцию, подходящую для вашей платформы:
ПлатформаПодход**Web — SDK**Встройте journey с помощью `idpay-b2b-sdk` → [Web Integration](/ru/human-token/integrations/web/web-integration/)**Web — Redirect**Перенаправьте пользователя на `link` → [Web Integration](/ru/human-token/integrations/web/web-integration/)**Android**Custom Tabs → [Android](/ru/human-token/integrations/app/android)**iOS**ASWebAuthenticationSession → [iOS](/ru/human-token/integrations/app/ios)**Ionic**Capacitor plugin → [Ionic](/ru/human-token/integrations/app/ionic)**React Native**Native module → [React Native](/ru/human-token/integrations/app/react-native)**Flutter**Platform Channels → [Flutter](/ru/human-token/integrations/app/flutter)
Когда journey завершается, пользователь возвращается на ваш `callbackUri`. Перейдите к шагу 4.
Потоки API OnlyПропустите этот шаг — результат уже содержится в ответе Create Process.

### Шаг 4 — Получить результат (только потоки Journey)​

Вызовите [Get Process](/ru/human-token/api-reference/get-process) с `id` процесса, чтобы получить результат:
```
curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

Ответ включает `data.humanToken.value` (стандартные потоки) или `data.humanTokenMatch` (потоки ревалидации). См. [Get Process](/ru/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](/ru/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](/ru/human-token/api-reference/get-selfie) для деталей ответа и кодов ошибок.

### Эндпоинты обзорно​

МетодЭндпоинтОписание`POST``/client/v1/process`[Create Process](/ru/human-token/api-reference/post-processes) — начать верификацию`GET``/client/v1/process/{processId}`[Get Process](/ru/human-token/api-reference/get-process) — получить результат`GET``/client/v1/process/{processId}/selfie`[Get Selfie](/ru/human-token/api-reference/get-selfie) — скачать селфи (24 ч)
### Что дальше​

[Create Process](/ru/human-token/api-reference/post-processes) — полный справочник параметров для всех пяти потоков
[Authentication](/ru/human-token/get-started/authentication) — генерация и управление к лючами доступа
[Build With LLM](/ru/human-token/api-reference/build-with-llm) — вставьте промпт в ваш AI-ассистент для генерации полной интеграции
Последнее обновление 22 окт. 2026 г.**