--- title: Создать процесс description: Создайте процесс Human Token в Human API — отправьте селфи (API Only) или запустите Human Token Journey — и получите humanToken в data.humanToken. canonical: https://developer.unico.io/ru/human-token/api-reference/post-processes locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - Справочник API - Создать процесс **На этой страницеСоздать процессPOSTСоздайте процесс Human Token со своего бэкенда и получите humanToken в data.humanToken. Human Token работает на эндпоинте Human API `POST /client/v1/process`. С потоками API Only (`api+humantoken`, `api+liveness+humantoken` и `api+liveness+humantoken+revalidation`) процесс создаётся и завершается за один вызов: ответ уже содержит результат в `data.humanToken`. С потоками Human Token Journey (`humantoken` и `humantoken+revalidation`) ответ содержит `id` процесса, `token` и `link` сценария, а результат становится доступен после того, как пользователь пройдёт сценарий. Потоки `+revalidation` требуют массив `references` с ранее полученным `humanToken` для повторной валидации. ### Потоки​ Human Token работает в двух моделях интеграции: **API Only** — ваш бэкенд отправляет селфи в `imageBase64`. **Human Token Journey** — пользователь проходит сценарий Unico в Web и возвращается на ваш `callbackUri`. FlowCapabilitiesPossible resultIntegration componentsrequiredExample`api+humantoken`[Human Token](/ru/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken`Liveness[Human Token](/ru/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken+revalidation`Liveness[Human Token](/ru/human-token/)RevalidationPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`humantoken`Liveness[Human Token](/ru/human-token/)PROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example`humantoken+revalidation`Liveness[Human Token](/ru/human-token/)RevalidationPROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example ### Эндпоинт​ СредаURL**Production**`POST https://humantoken.unico.app/client/v1/process` ### Запрос​ Заголовки ЗаголовокЗначение`x-unico-accesskey``` (см. [Аутентификация](/ru/human-token/get-started/authentication))`Content-Type``application/json` Параметры тела запроса ПолеТипОбязательноОписание`flow`stringдаПоток Human Token: `api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation` (API Only) или `humantoken`, `humantoken+revalidation` (Human Token Journey). См. [Потоки](#flows).`imageBase64`stringAPI OnlyСелфи, захваченное вашим фронтендом и отправленное напрямую, в base64. PNG, JPEG или WebP, до 800 КБ. Следуйте [стандарту захвата](/ru/human-token/additional-resources/capture-standard).`callbackUri`stringHuman Token JourneyURL, на который перенаправляется пользователь после завершения сценария.`companyBranchId`stringнетИдентификатор ветки. При указании процесс использует конфигурацию указанной ветки.`references`arrayПотоки повторной валидацииМассив объектов-ссылок. Обязателен для потоков `+revalidation`. Каждый объект содержит `referenceType` (`REFERENCE_TYPE_HUMAN_TOKEN`) и `referenceContent` (ранее полученное значение `humanToken`). ### Ответы​ 200 OK ПолеТипОписание`id`string (UUID)Идентификатор процесса. Используйте его, чтобы повторно получить процесс через [Получение процесса](/ru/human-token/api-reference/get-process).`state`stringСостояние процесса — см. [Интерпретация результата](#interpreting-the-result). Только в потоках API Only.`token`stringТокен созданного процесса, его можно использовать для открытия интерфейса Journey SDK. Только в потоках Human Token Journey (`humantoken`, `humantoken+revalidation`).`link`stringURL сценария Human Token Journey: направьте пользователя по нему. Только в потоках Human Token Journey (`humantoken`, `humantoken+revalidation`).`data.​humanToken.​value`stringСтабильный непрозрачный идентификатор лица (до 100 символов). Один и тот же человек всегда соответствует одному и тому же значению. Только в потоках API Only (без повторной валидации).`data.​humanTokenMatch`string`"true"`, если селфи совпадает с указанным `humanToken`, `"false"` в противном случае. Только в потоке `+revalidation` API Only. Интерпретация результата `state`ЗначениеЧто делать`PROCESS_STATE_FINISHED``data.humanToken.value` заполнено: реальный человек с Human Token.Найдите `value` в своих записях: если значение есть, это вернувшийся пользователь или возможный дубликат; если нет — это новый человек.`PROCESS_STATE_FINISHED`Нет `data.humanToken` или `value` пустое: результат неопределённый.Считайте результат неокончательным. Никогда не сохраняйте и не сопоставляйте пустое `value`; повторите процесс или отклоните его в соответствии с вашими бизнес-правилами.`PROCESS_STATE_FAILED`Процесс идентификации завершился ошибкой.Повторите процесс или отклоните его согласно вашим бизнес-правилам.`PROCESS_STATE_CREATED`Процесс создан.Подождите. Получите результат позже через [Получение процесса](/ru/human-token/api-reference/get-process).`PROCESS_STATE_CANCELED`Процесс был отменён.Создайте новый процесс, если пользователя всё ещё нужно проверить. предупреждениеВсегда проверяйте, что `data.humanToken.value` не пусто, прежде чем использовать его. ### Коды ошибок​ примечаниеHTTP-статус, который возвращается, когда ключ доступа в заголовке `x-unico-accesskey` отсутствует или недействителен, ещё уточняется. См. [Аутентификация](/ru/human-token/get-started/authentication). 400 Bad Request403 Forbidden429 Too Many Requests500 Internal Server ErrorКодСообщениеОписание`3`invalid flowКогда указанный поток не существует.`3`INVALID_IMAGEКогда изображение не является корректным base64 или похоже на попытку инъекции.`3`IMAGE_TOO_LARGEКогда изображение превышает максимальный размер 800 КБ.`3`UNSUPPORTED_IMAGE_FORMATКогда формат изображения не PNG, JPEG или WebP.`3`MISSING_IMAGEКогда изображение обязательно для этого потока, но не было отправлено.`3`INVALID_REQUESTКогда тело запроса равно null или не может быть интерпретировано.`9`monthly process limit of reached for this tenantКогда достигнут ежемесячный лимит использования.`9`PROCESS_FAILEDКогда процесс завершился терминальной ошибкой во время создания.КодСообщениеОписание`7`PERMISSION_DENIEDКогда учётные данные действительны, но не дают права на это действие.Достигнут лимит запросов. Когда ваша система получает ошибку HTTP 429, необходимо реализовать механизмы для предотвращения каскадных сбоев и избежания усугубления ограничения. **Лучшие практики:** **Период ожидания (backoff):** Немедленно остановите или снизьте частоту последующих запросов из вашей системы. Не повторяйте неудачные запросы непрерывно в тесном цикле. **Очередь и ограничение (Queueing & throttling):** Буферизируйте или ставьте в очередь исходящие запросы на вашей стороне для контроля потока трафика перед их повторной отправкой. **Экспоненциальный backoff с джиттером:** При повторных попытках увеличивайте время ожидания экспоненциально между попытками (например, 1 с, 2 с, 4 с, 8 с) и добавляйте небольшую случайную задержку ("джиттер"), чтобы предотвратить эффект стада, когда все запросы из очереди повторяются в одну и ту же миллисекунду. предупреждениеНепрерывная отправка запросов к эндпоинту с ограничением частоты без применения backoff может **продлить период ограничения** и серьезно снизить операционную пропускную способность вашей системы. Правильное ограничение запросов на вашей стороне обеспечивает более плавную и устойчивую интеграцию. Информацию о лимитах по умолчанию, увеличении запросов и дополнительные сведения см. в разделе [Лимиты запросов](/ru/developers/start/rate-limits).КодСообщениеОписание`13`Internal failure! Try again laterКогда возникает внутренняя ошибка. Полный список кодов этого эндпоинта см. в справочнике Human API [Создать процесс](/ru/developers/api-reference/post-processes#error-codes). ### Что дальше​ Сохраните значение `humanToken` вместе с записью пользователя, чтобы распознавать того же человека при последующих вызовах Human Token. Чтобы повторно получить процесс для аудита или поддержки, используйте [Получение процесса](/ru/human-token/api-reference/get-process). Последнее обновление 22 окт. 2026 г.**