Обзор
Выбор контракта
Выбор контракта определяется местом биометрического захвата — это не самостоятельное решение. Используйте таблицу ниже в качестве руководства.
| Контракт | Использовать, когда… | Захват | Поток |
|---|---|---|---|
| Web & SDK | Процесс захвата обеспечивается Unico (Web iFrame, Redirect или нативный SDK) | Контролируется Unico | Процесс создаётся до захвата → пользователь проходит через сценарий → результат возвращается через callback или polling |
| API | Ваше приложение контролирует захват (с Unico SDK или без) и отправляет изображение непосредственно в вызове | Контролируется клиентом | Изображение отправляется вместе с созданием процесса → результат возвращается синхронно |
Хосты и среды
| Контракт | Хост sandbox | Хост production |
|---|---|---|
| Web & SDK | https://api.idcloud.uat.unico.app | https://api.idcloud.unico.app |
| API | https://api.id.uat.unico.app | https://api.id.unico.app |
| OAuth2 / Token | https://identityhomolog.acesso.io | https://identity.acesso.io |
Подробности в разделе Среды.
Аутентификация
Все контракты Unico используют Bearer-токен (JWT), получаемый через OAuth2 с urn:ietf:params:oauth:grant-type:jwt-bearer.
Подробности в разделе Аутентификация.
Различия payload между контрактами
Одна и та же концептуальная операция («создать процесс верификации личности») выглядит по-разному в каждом контракте. Используйте таблицы ниже как краткий справочник при переходе между интеграциями.
Process creation
| Аспект | Web & SDK | API |
|---|---|---|
| Эндпоинт | POST /client/v1/process | POST /processes/v1 |
| Аутентификация | Authorization: Bearer <jwt> | Authorization: Bearer <jwt> + APIKEY |
| Изображение | Не отправляется (захватывается в сценарии Unico) | Отправляется как imageBase64 |
| Идентификация пользователя | person.duiType + person.duiValue | subject.code (CPF / CURP) |
| Типы документов | CPF, CURP, SSN, NIN, DNI, NIK | Только CPF, CURP |
| Определение pipeline | flow (enum, 30+ значений) | Неявно в APIKEY (возможности) |
| Callback | callbackUri (перенаправление пользователя) | Нет (синхронный) |
| Webhook | Webhook v1 (итоговый результат) | Webhook v1 (опционально) |
| Возвращает URL сценария | Да (userRedirectUrl) | Нет |
| Результат | Асинхронный (GET polling или webhook) | Синхронный (в ответе) |
| SDK-токен | Да (token, webAppToken) | Нет |
Result retrieval
| Аспект | Web & SDK | API |
|---|---|---|
| Эндпоинт | GET /client/v1/process/\{id\} | GET /processes/v1/\{id\} (также в ответе на создание) |
| Статус | state + result (с префиксами enum) | status (1, 3, 5) |
| Структура результата | Вложена в process.authenticationInfo.{capability}Result. В Мексике — idGov в authenticationInfo. | Плоская: unicoId, liveness, government, identityFraudsters, idGov (только Мексика) |
| Документ | services[].documents[] (RG/CNH с OCR) | Отдельный эндпоинт (GET /processes/v1/\{id\}/document) |
Что дальше
- Аутентификация — поток OAuth2 и генерация JWT
- Среды — sandbox и production
- Коллекция Postman — готовые к использованию коллекции
- Webhooks и события — асинхронная доставка результатов
- SDK и инструменты — Web SDK, Android, iOS, Flutter