---
title: Обзор
description: Справочник по IDCloud API — два публичных контракта (Web & SDK и API).
canonical: https://developer.unico.io/ru/dual-api/developers/api-reference/
locale: ru
generated_by: markdown-export
---

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

**На этой странице# Обзор

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

Выбор контракта определяется **местом биометрического захвата** — это не самостоятельное решение. Используйте таблицу ниже в качестве руководства.
КонтрактИспользовать, когда…ЗахватПоток**[Web & SDK](/ru/dual-api/developers/api-reference/web-sdk)**Процесс захвата обеспечивается Unico (Web iFrame, Redirect или нативный SDK)Контролируется UnicoПроцесс создаётся **до** захвата → пользователь проходит через сценарий → результат возвращается через callback или polling**[API](/ru/dual-api/developers/api-reference/api)**Ваше приложение контролирует захват (с Unico SDK или без) и отправляет изображение непосредственно в вызовеКонтролируется клиентомИзображение отправляется **вместе** с созданием процесса → результат возвращается синхронно
### Хосты и среды​

КонтрактХост sandboxХост productionWeb & 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`
Подробности в разделе [Среды](/ru/dual-api/developers/api-reference/environments).
### Аутентификация​

Все контракты Unico используют **Bearer-токен (JWT)**, получаемый через OAuth2 с `urn:ietf:params:oauth:grant-type:jwt-bearer`.
Подробности в разделе [Аутентификация](/ru/dual-api/developers/api-reference/authentication).
### Различия payload между контрактами​

Одна и та же концептуальная операция («создать процесс верификации личности») выглядит по-разному в каждом контракте. Используйте таблицы ниже как краткий справочник при переходе между интеграциями.
Process creation
АспектWeb & SDKAPI**Эндпоинт**`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 & SDKAPI**Эндпоинт**`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`)
### Что дальше​

[Аутентификация](/ru/dual-api/developers/api-reference/authentication) — поток OAuth2 и генерация JWT
[Среды](/ru/dual-api/developers/api-reference/environments) — sandbox и production
[Коллекция Postman](/ru/dual-api/developers/api-reference/postman) — готовые к использованию коллекции
[Webhooks и события](/ru/developers/webhooks-and-events) — асинхронная доставка результатов
[SDK и инструменты](/ru/developers/sdks-and-tools/overview) — Web SDK, Android, iOS, Flutter
Последнее обновление 8 окт. 2026 г.**