---
title: Часто задаваемые вопросы
description: Часто задаваемые вопросы об IDCloud — интеграция, аутентификация, коды ошибок и поддерживаемые платформы.
canonical: https://developer.unico.io/ru/dual-api/resources/faq
locale: ru
generated_by: markdown-export
---

### Стандарты HTTP и заголовки

## Есть ли рекомендуемый стандарт HTTP-заголовков от Unico?

Unico рекомендует соответствие актуальным спецификациям HTTP (первоначально определённым в RFC 7230 и 7231, теперь заменённым RFC 9110 и смежными стандартами). Несовместимые заголовки могут вызывать сбои интеграции, такие как ошибки «415 (Unsupported Media Type)» или «502 (Bad Gateway)», из-за отклонения прокси.

Типичные нарушения включают недопустимые значения `Content-Encoding`, имена заголовков с пробелами, акцентами или не-ASCII-символами, управляющие символы в значениях и запрещённое дублирование заголовков. Всегда проверяйте соответствие заголовков перед отправкой запросов.

### Сертификаты и безопасность

## Рекомендует ли Unico certificate pinning?

Нет. Certificate pinning может вызывать недоступность сервиса во время плановых циклов замены сертификатов. Он даёт минимальные преимущества в плане безопасности и блокирует современные средства защиты (CDN, WAF, защита от атак). Unico обеспечивает безопасность соединений через глобально признанные центры сертификации, публичный аудит через Certificate Transparency и надёжные стандарты аутентификации, такие как OAuth + JWT.

## Почему я не могу использовать ссылку by Unico в обычном iframe без токена?

Прямое встраивание без токенов аутентификации запрещено по соображениям безопасности, отслеживаемости и контроля доступа. Требуется защищённый токен сессии, генерируемый для каждого запроса и привязанный к транзакции, пользователю и контексту.

Риски прямых ссылок включают уязвимости социальной инженерии и фишинга, потерю целостности, пробелы в цепочке аудита и раскрытие политик безопасности, что увеличивает риски перечисления или превышает ограничения размера заголовков.

### База данных и обработка

## Могу ли я импортировать свою базу данных для обработки Unico?

Да. Процесс требует уведомления вашего менеджера по работе с клиентами, запроса сервисного аккаунта, получения APIKey, настроенного для изображений в base64 (не зашифрованных), и выполнения API-вызовов с сохранением данных ответов и идентификаторов процессов — что необходимо для таких функций, как Валидация 1:1.

### Производительность и ограничение запросов

## Есть ли у Unico ограничение TPS/RPM?

Да. Стандартное ограничение составляет 10 TPS (транзакций в секунду) на клиента для обеспечения стабильности и безопасности платформы. Ограничения регулируются договором и могут быть временно или постоянно увеличены через вашего менеджера по работе с клиентами. Запросы, превышающие лимиты, получают ошибки `429 (Too Many Requests)`.

### Типы интеграции

## В чём разница между интеграциями через API и Web & Native?

**Web & Native**: Unico управляет полным пользовательским опытом с лучшими практиками UX и безопасности, автоматическими обновлениями SDK и оптимизацией конверсии. Доступно через webview, iframe или асинхронные сообщения (WhatsApp, SMS, Email).

**API**: Компании контролируют пользовательский опыт через собственный frontend, используя возможности бэкенда Unico наряду с другими технологиями аутентификации.

### Оркестрация

## Что такое оркестрация?

При биометрической регистрации, когда Проверка личности возвращает «Неопределённый» результат, оркестрация автоматически выполняет вероятностную валидацию с использованием возможности Классификация риска мошенничества для определения соответствия лица держателю документа, удостоверяющего личность.

### Web & Native — развёртывание и кастомизация

## Как я могу использовать Web & Native в своей работе?

Доступны три метода развёртывания: webview в мобильных приложениях, iframe в веб-приложениях или потоки через сообщения (WhatsApp, SMS, Email).

## Какие кастомизации доступны в Web & Native?

Настраиваемые элементы включают логотип, цвет фона CTA, текст CTA и скругление углов CTA (в пикселях).

### Технологии документов

## Как работают технологии документов?

- **Типификация**: Проверяет, соответствует ли макет документа указанному типу (криминалистическая экспертиза не проводится).
- **FaceMatch**: Сравнивает селфи пользователя с фотографией лица на документе (возврат true/false).
- **CPF Match**: Сравнивает предоставленный CPF с CPF на документе (возврат true/false).
- **Извлечение через OCR**: Преобразует данные документа в текстовый формат из изображений.

## Проводит ли Unico криминалистическую экспертизу документов?

Нет. Unico предоставляет типификацию, извлечение данных через OCR, FaceMatch и CPF Match — но в настоящее время не выполняет криминалистическую экспертизу документов.

### Характеристики API

## Могу ли я использовать IDCloud вручную?

Да, ручное использование поддерживается.

## IDUnico API синхронный или асинхронный?

Доступны оба варианта. Выберите предпочтительный метод интеграции при настройке APIKey.

## Каково среднее время ответа для проверки личности?

Ожидаемая задержка в среднем составляет 3 секунды, но может варьироваться в зависимости от способа использования продукта (например, используется ли Проверка живости, синхронный или асинхронный APIKey и другие факторы).

### Ответы API и решения

## Каковы ответы IDUnico API для решений об одобрении?

Наиболее распространённый сценарий (Проверка личности + Классификация риска мошенничества) возвращает:

```json
{
  "id": "abc-123",
  "status": 3,
  "unicoId": {
    "result": "yes"
  },
  "liveness": 1,
  "score": 87.5
}
```

### Дополнительные функции и обработка ошибок

## Есть ли в продуктах Unico схожесть Serpro?

Да. IDCloud предлагает функциональность схожести Serpro через API и Web & Native, возвращая процент схожести Serpro — часто используется для потоков займов на заработную плату. Serpro (Serviço Federal de Processamento de Dados) — это служба обработки данных федерального правительства Бразилии, которая ведёт национальный реестр удостоверений личности, используемый для сравнения.

## Каковы наиболее распространённые коды ошибок?

| Код | Описание |
|---|---|
| `400` | Ошибки запроса |
| `401` | Аутентификация отсутствует или недействительна |
| `403` | Ошибки разрешений |
| `404` | Данные не найдены |
| `429` | Превышен лимит запросов |
| `500` | Ошибки сервера и непредвиденные сбои |

## Что происходит при сбое биометрического захвата?

**Web & Native**: Управляемый опыт позволяет пользователям повторять попытки с высокими показателями конверсии.

**API**: Ошибки должны обрабатываться как исключения в вашем API. Ознакомьтесь с документацией по кодам ошибок и сопоставлению сценариев.