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

- [/ru/](/ru/)
- Справочник API
- Получение процесса

**На этой страницеПолучение процессаGETПолучите процесс Human Token по его идентификатору — после возвращения пользователя из Human Token Journey или для повторного запроса результата API Only.

### Эндпоинт​

СредаURL**Production**`GET https://humantoken.unico.app/client/v1/process/{processId}`
### Запрос​

Заголовки
ЗаголовокЗначение`x-unico-accesskey``<your_access_key>` (см. [Аутентификация](/ru/human-token/get-started/authentication))
Параметры пути
ПараметрТипОбязательноОписание`processId`string (UUID)даИдентификатор процесса, возвращённый [Создать процесс](/ru/human-token/api-reference/post-processes).
### Пример​

cURLNode.js```
curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

```
import fetch from 'node-fetch';const res = await fetch(  `https://humantoken.unico.app/client/v1/process/${processId}`,  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } });const result = await res.json();// result.data.humanToken.value
```

### Ответы​

200 OK
Ответ имеет тот же формат, что и в [Создать процесс](/ru/human-token/api-reference/post-processes#responses). Структура `data` зависит от потока, использованного при создании процесса.
**Стандартные потоки** (`api+humantoken`, `api+liveness+humantoken`, `humantoken`):
```
{  "id": "6ed74799-4c2f-4023-b43f-a73cf7c847b2",  "state": "PROCESS_STATE_FINISHED",  "data": {    "humanToken": {      "value": "3f9a1c7e5b2d4086a1e3c5f7092b4d6e8a0c2e4f6183a5c7e9b1d3f5072a4c6e",      "status": "validated"    }  }}
```

**Потоки ревалидации** (`api+liveness+humantoken+revalidation`, `humantoken+revalidation`):
```
{  "id": "cb0472c0-6dbc-46c6-b830-2be7edc35424",  "state": "PROCESS_STATE_FINISHED",  "data": {    "humanTokenMatch": "true"  }}
```

ПолеТипОписание`id`string (UUID)Идентификатор процесса.`state`stringСостояние процесса — см. [значения `state`](#state-values).`data.​humanToken.​value`stringТолько стандартные потоки. Стабильный непрозрачный идентификатор лица (до 100 символов). Один и тот же человек всегда соответствует одному и тому же значению.`data.​humanTokenMatch`stringТолько потоки ревалидации. `"true"`, если селфи совпадает с указанным `humanToken`, `"false"` в противном случае.
Значения state
ЗначениеОписание`PROCESS_STATE_UNSPECIFIED`Состояние не задано.`PROCESS_STATE_CREATED`Процесс создан и всё ещё принимает новые сессии. `data` равно `{}`.`PROCESS_STATE_FINISHED`Процесс завершён и больше не принимает новые сессии. Для стандартных потоков `data.humanToken` присутст вует, если Human Token был сгенерирован; для потоков ревалидации `data.humanTokenMatch` показывает, совпало ли селфи с указанным токеном. Иначе `data` равно `{}`.`PROCESS_STATE_FAILED`Процесс завершился ошибкой. `data` равно `{}`.`PROCESS_STATE_CANCELED`Процесс отменён. `data` равно `{}`.`PROCESS_STATE_AWAITING_FOR_DOCUMENT`Процесс ожидает документ, удостоверяющий личность. `data` равно `{}`.
предупреждениеВсегда проверяйте, что `data.humanToken.value` не пусто, прежде чем использовать его.
### Коды ошибок​

400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server ErrorКодСообщениеОписание`3`process id is invalidКогда идентификатор процесса недействителен.Ключ доступа отсутствует или недействителен в заголовке `x-unico-accesskey`. См. [Аутентификация](/ru/human-token/get-started/authentication).КодСообщениеОписание`5`error getting process: rpc error: code = NotFound desc = process not foundКогда процесс с указанным идентификатором не найден.Достигнут лимит запросов. Когда ваша система получает ошибку HTTP 429, необходимо реализовать механизмы для предотвращения каскадных сбоев и избежания усугубления ограничения.
**Лучшие практики:**

**Период ожидания (backoff):** Немедленно остановите или снизьте частоту последующих запросов из вашей системы. Не повторяйте неудачные запрос ы непрерывно в тесном цикле.
**Очередь и ограничение (Queueing & throttling):** Буферизируйте или ставьте в очередь исходящие запросы на вашей стороне для контроля потока трафика перед их повторной отправкой.
**Экспоненциальный backoff с джиттером:** При повторных попытках увеличивайте время ожидания экспоненциально между попытками (например, 1 с, 2 с, 4 с, 8 с) и добавляйте небольшую случайную задержку ("джиттер"), чтобы предотвратить эффект стада, когда все запросы из очереди повторяются в одну и ту же миллисекунду.

предупреждениеНепрерывная отправка запросов к эндпоинту с ограничением частоты без применения backoff может **продлить период ограничения** и серьезно снизить операционную пропускную способность вашей системы. Правильное ограничение запросов на вашей стороне обеспечивает более плавную и устойчивую интеграцию.
Информацию о лимитах по умолчанию, увеличении запросов и дополнительные сведения см. в разделе [Лимиты запросов](/ru/developers/start/rate-limits).КодСообщениеОписание`99999`Internal failure! Try again laterКогда возникает внутренняя ошибка.
### Что дальше​

Вернитесь к [Создать процесс](/ru/human-token/api-reference/post-processes), чтобы отправить новое селфи.
Чтобы понять, что представляет собой `humanToken` и когда он не генерируется, см. [обзор Human Token](/ru/human-token/).
Последнее обновление 22 окт. 2026 г.**