--- title: Повторная обработка и импорт биометрической базы description: Руководство по повторной обработке биометрических записей или импорту биометрической базы на платформу Unico. canonical: https://developer.unico.io/ru/dual-api/resources/reprocessing locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - Ресурсы - Повторная обработка и импорт биометрической базы **На этой странице# Повторная обработка и импорт биометрической базы Это руководство описывает, как выполнить **повторную обработку** или **импорт биометрической базы** на платформе Unico. В нём подробно описаны технические и операционные требования для эффективной и безопасной интеграции в соответствии с лучшими практиками платформы. ### Область применения​ Данный материал охватывает два типа процессов: **Повторная обработка**: повторная обработка биометрических записей пользователей, которые уже прошли через базу клиента и Unico, для переоценки или миграции между системами. **Импорт биометрической базы**: первичная загрузка или обновление базы, содержащей селфи для верификации личности и/или классификации рисков. **Импорт базы документов**: загрузка базы документов вместе с селфи для верификации по Facematch или CPF Match (только для Бразилии). ### Предварительные требования​ У клиента **должен быть действующий контракт или NDA**, подписанный с Unico, и он должен находиться на этапе интеграции (исключение при одобрении командой governance). Проект будет следовать формальным **соглашениям TPS (транзакций в секунду)**. См. раздел [Соглашение TPS](#tps-agreement) ниже. Перед получением продуктивных учётных данных **обязательна полная гомологация интеграции** для обеспечения качества данных, соответствия payload и стабильной производительности. Для повторной обработки или импорта необходимо создать **выделенную сервисную учётную запись** (например, "Reprocessing" или "Legacy_Import"). Для повторной обработки/импорта будет создан **выделенный API Key**. **(Необязательно)** Для повторной обработки/импорта может быть создан выделенный филиал. Этот параметр указывается в payload как `subsidiaryId`. См. раздел [Параметры payload](#payload-parameters) ниже. API Key и сервисная учётная запись **будут деактивированы** после согласованного периода или завершения обработки. ### Доступные capabilities​ CapabilityОписание**Identity Verification**Проверяет, принадлежит ли отправленное селфи реальному владельцу идентификатора.**Risk Fraud Classification**Проверяет наличие истории мошеннического поведения, связанного с данным лицом.**Facematch**Проверяет, соответствует ли фотография в документе отправленному селфи.**CPF Match** Brazil onlyПроверяет, соответствует ли предоставленный CPF номеру CPF, напечатанному на документе. Примечание: не все RG содержат напечатанный CPF. ### Требования к селфи​ Должно быть отправлено в формате **base64**. Изображение должно соответствовать **стандарту ICAO** (светлый фон, центрированное лицо, отсутствие аксессуаров, затрудняющих идентификацию, надлежащее освещение). Рекомендуемые размеры: **1080x1920** (книжная ориентация) или **1920x1080** (альбомная ориентация). Максимальный размер: **800 КБ** (при необходимости сжимайте с помощью JPEG 92). Ориентация: **портретная**. ### Требования к документам​ **Поддерживаемые типы документов**: см. [Распознавание документов и повторное использование — Поддерживаемые документы](/ru/capabilities/document-reuse-and-capture#supported-documents). Изображения должны включать как **лицевую, так и оборотную** сторону документа, полностью видимые без обрезки. Документ должен быть **читаемым** — чётким, хорошо освещённым и без помех. ### Соглашение TPS​ Максимальный согласованный TPS для данного проекта составляет **10 TPS**. Распределяйте запросы равномерно по времени, а не отправляйте их большими пакетами. Этот лимит **не должен быть превышен** без формального одобрения команды Unico. Запросы, превышающие лимит, могут быть автоматически отклонены или заблокированы. Если необходимо временное увеличение, требуется **формальное предварительное согласование**. ### Интеграция​ #### Endpoints​ СредаБазовый URLДоступПримечанияStaging`https://api.id.uat.unico.app`ОткрытыйОбязательно для тестированияProduction`https://api.id.unico.app`Только после утверждённой гомологацииТребуется строгий контроль TPS #### Обязательные заголовки​ ``` Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json ``` #### Параметры payload​ ``` { "subject": { "duiType": 1, "code": "11032395702", "name": "User Name", "email": "username@gmail.io", "phone": "21998571922", "birthDate": "30/07/1989", "gender": "M" }, "useCase": "Reprocessamento/Importação", "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819", "imageBase64": "/9j/4AAQSkZJR...", "document": { "purpose": "Reprocessamento", "documentId": "doc-001", "files": [ { "data": "doc_base64_frente", "faceDocumentMatch": true }, { "data": "doc_base64_verso" } ] }} ``` ПолеТипОбязательноеОписание`subject`objectДаИдентификационные данные пользователя.`subject.duiType`integerДаИдентификатор типа документа. См. [значения `duiType`](#duitype-values) ниже.`subject.code`stringДаCPF или другой идентификатор пользователя.`subject.name`stringДаПолное имя пользователя.`subject.email`stringНетЭлектронная почта пользователя.`subject.phone`stringНетНомер телефона пользователя.`subject.birthDate`stringНетДата рождения пользователя (`DD/MM/YYYY`).`subject.gender`stringНетПол пользователя (`M` или `F`).`useCase`stringДаНазвание сценария использования ("Reprocessamento" или "Importação de base").`subsidiaryId`stringНетUUID филиала (предоставляется Unico).`imageBase64`base64ДаСелфи пользователя, конвертированное в base64.`document`objectНетДанные документа, связанного с процессом.`document.purpose`stringНетНазначение документа (например, `"Reprocessamento"`).`document.documentId`stringНетИдентификатор документа.`document.files`arrayНетСписок файлов изображений документа.`document.files[].data`base64НетИзображение документа, конвертированное в base64.`document.files[].faceDocumentMatch`booleanНетУказывает, совпадает ли лицо в документе с отправленным селфи. **Значения `duiType`**СтранаКодОписаниеAR6Аргентинский паспортAR7Аргентинский DNIAR49Аргентинское водительское удостоверение (Licencia Nacional de Conducir)AT34Австрийский налоговый номер (STNR)BE36Бельгийский национальный номер (NN)BR1Бразильский CPFBR5Бразильский паспортBR14Бразильский CNPJCA28Канадский SINCH33Швейцарский номер AHV/AVSCL9Чилийский RUNCL52Чилийский паспортCL57Чилийское водительское удостоверение (Licencia de Conducir)CO26Колумбийский NITCO53Колумбийский паспортCO55Колумбийское водительское удостоверение (Licencia de Conducción)CO56Колумбийское удостоверение личности гражданина (Cédula de Ciudadanía)DE41Немецкий налоговый идентификационный номер (IdNr)DK29Датский CPREC10Эквадорский NIES50Испанский номер иностранца (NIE)ES51Испанский национальный документ, удостоверяющий личность (DNI)FI35Финский код личной идентификации (HETU)FR46Французский налоговый справочный номер (SPI)GB30Британский номер национального страхования (NINO)GT12Гватемальский CUIID16Индонезийский NIKIE47Ирландский номер социального страхования (PPSN)IT37Итальянский налоговый код (Codice Fiscale, CF)LU48Люксембургский национальный идентификационный номер (Matricule)MX2Мексиканский CURPMX25Мексиканский RFC (физическое лицо)MX58Мексиканское водительское удостоверение (Licencia de Conducir)NG8Нигерийский NINNG20Нигерийский номер верификации банковского счёта (BVN)NG43Токен BVN Нигерии (хешированный)NG44Токен NIN Нигерии (хешированный)NL42Голландский идентификационный номер гражданина (BSN)NO39Норвежский национальный идентификационный номер (Fødselsnummer)PE27Перуанский RUCPE40Перуанский DNIPE54Перуанский паспортPL31Польский PESELPT45Португальский налоговый идентификационный номер (NIF)SE32Шведский личный номер (PNR)SE38Шведский координационный номер (Samordningsnummer)TR24Турецкий идентификационный номер (TCKN)US4SSN СШАUS11Паспорт СШАUS18Водительское удостоверение СШАUS21Паспортная карта СШАUS22Поликарбонатный паспорт СШАUS23Идентификационная карта СШАUY13Уругвайский CIZZ15Адрес электронной почтыZZ17Номер телефона—0Не указано—3Внутренний идентификатор Unico #### Важные замечания​ Селфи **должно соответствовать стандарту ICAO** с надлежащим качеством и освещением. Селфи должно быть в формате **base64**. Избегайте массовых отправок без контроля TPS — это может вызвать ограничение скорости (см. раздел [Обработка ошибок](#error-handling) ниже). Всегда сначала тестируйте данные и интеграцию в среде staging. #### Ответы​ **Успех — 200 OK** Без документаС документом (Facematch)``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "unicoId": { "result": "inconclusive" }, "riskLevel": { "result": "inconclusive" }} ``` ПолеТипОписание`id`stringИдентификатор процесса. Сохраните его для будущих запросов или если вы планируете реализовать Валидацию 1:1 позже.`status`integerСтатус транзакции.`unicoId.result`stringОтвет возможности «Верификация личности».`riskLevel.result`stringРезультат классификации рисков мошенничества. Возможные значения: `reproved`, `risk-critical`, `risk-high`, `inconclusive`.``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "score": 0, "status": 3, "unicoId": { "result": "yes" }, "faceDocumentMatch": { "faceMatch": true }, "riskLevel": { "result": "inconclusive" }} ``` ПолеТипОписание`id`stringИдентификатор процесса. Сохраните его для будущих запросов или если вы планируете реализовать Валидацию 1:1 позже.`status`integerСтатус транзакции.`score`numberОценка Facematch.`unicoId.result`stringОтвет возможности «Верификация личности».`faceDocumentMatch.faceMatch`booleanСоответствует ли фотография в документе отправленному селфи.`riskLevel.result`stringРезультат классификации рисков мошенничества. Возможные значения: `reproved`, `risk-critical`, `risk-high`, `inconclusive`. **Ошибка обработки изображения** ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 5} ``` **Распространённые ошибки** Коды в диапазоне `4xx` указывают на ошибки валидации предоставленных данных. Коды в диапазоне `5xx` указывают на сбои на стороне сервера. HTTP-кодТип ошибкиВероятная причинаРекомендуемое действие`400`Bad RequestНекорректный payloadПроверьте структуру и содержимое.`401`UnauthorizedИстёкший или недействительный токенСгенерируйте токен заново.`403`ForbiddenНеверный API Key или недостаточные разрешенияПроверьте учётные данные.`429`Too Many RequestsПревышена частота запросовПодождите и соблюдайте лимит TPS.`500+`Internal Server ErrorВнутренний сбойПовторите попытку через несколько секунд; откройте тикет при постоянных ошибках. ### Обработка ошибок​ **Rate Limit (HTTP 429)** необходимо тщательно отслеживать. Перегрузка запросами может заблокировать конвейер. Всегда соблюдайте TPS, согласованный с Unico (см. раздел [Соглашение TPS](#tps-agreement)). При постоянных сбоях (5xx) выполняйте повторную обработку с контролем retry/backoff. Последнее обновление 8 окт. 2026 г.**