Перейти к основному содержимому

Обзор

Выбор контракта

Выбор контракта определяется местом биометрического захвата — это не самостоятельное решение. Используйте таблицу ниже в качестве руководства.

КонтрактИспользовать, когда…ЗахватПоток
Web & SDKПроцесс захвата обеспечивается Unico (Web iFrame, Redirect или нативный SDK)Контролируется UnicoПроцесс создаётся до захвата → пользователь проходит через сценарий → результат возвращается через callback или polling
APIВаше приложение контролирует захват (с Unico SDK или без) и отправляет изображение непосредственно в вызовеКонтролируется клиентомИзображение отправляется вместе с созданием процесса → результат возвращается синхронно

Хосты и среды

КонтрактХост sandboxХост production
Web & SDKhttps://api.idcloud.uat.unico.apphttps://api.idcloud.unico.app
APIhttps://api.id.uat.unico.apphttps://api.id.unico.app
OAuth2 / Tokenhttps://identityhomolog.acesso.iohttps://identity.acesso.io

Подробности в разделе Среды.

Аутентификация

Все контракты Unico используют Bearer-токен (JWT), получаемый через OAuth2 с urn:ietf:params:oauth:grant-type:jwt-bearer.

Подробности в разделе Аутентификация.

Различия payload между контрактами

Одна и та же концептуальная операция («создать процесс верификации личности») выглядит по-разному в каждом контракте. Используйте таблицы ниже как краткий справочник при переходе между интеграциями.

Process creation
АспектWeb & SDKAPI
ЭндпоинтPOST /client/v1/processPOST /processes/v1
АутентификацияAuthorization: Bearer <jwt>Authorization: Bearer <jwt> + APIKEY
ИзображениеНе отправляется (захватывается в сценарии Unico)Отправляется как imageBase64
Идентификация пользователяperson.duiType + person.duiValuesubject.code (CPF / CURP)
Типы документовCPF, CURP, SSN, NIN, DNI, NIKТолько CPF, CURP
Определение pipelineflow (enum, 30+ значений)Неявно в APIKEY (возможности)
CallbackcallbackUri (перенаправление пользователя)Нет (синхронный)
WebhookWebhook v1 (итоговый результат)Webhook v1 (опционально)
Возвращает URL сценарияДа (userRedirectUrl)Нет
РезультатАсинхронный (GET polling или webhook)Синхронный (в ответе)
SDK-токенДа (token, webAppToken)Нет
Result retrieval
АспектWeb & SDKAPI
ЭндпоинтGET /client/v1/process/\{id\}GET /processes/v1/\{id\} (также в ответе на создание)
Статусstate + result (с префиксами enum)status (1, 3, 5)
Структура результатаВложена в process.authenticationInfo.{capability}ResultПлоская: unicoId, liveness, government, identityFraudsters
Документservices[].documents[] (RG/CNH с OCR)Отдельный эндпоинт (GET /processes/v1/\{id\}/document)

Что дальше