Innovatrics
Esta integración te permite habilitar el SDK de Innovatrics en la plataforma y acceder a sus funcionalidades.
Nota
Es posible que la integración descrita en este artículo no se implemente en tu ambiente ni esté habilitada para todos tus clientes. Comunícate con tu administrador para recibir ayuda.
Detalles técnicos
ID de API | 508 |
Código de la API | INNOVATRICS |
Versión de la Call API | 2 |
Versión del SDK | iOS: [1.1.4] DotDocument, [3.3.1] DotFacePassiveLiveness. Última actualización: septiembre de 2020 Android: [2.3.0] DotDocument, [3.7.1] DotFacePassiveLiveness. Última actualización: julio de 2021 |
Versión de la app | 6.5.x |
Objetivo | Acceso a las funcionalidades de Innovatrics |
Disponible para | Android, iOS |
Uso de la integración de Innovatrics en Studio
Las siguientes funciones están disponibles para que las uses en tus procesos legacy y también puedes usarlas como bloques en los procesos lambda. Haz clic en cada función para obtener más detalles.
Obtiene los datos básicos de la Call API. | |
Busca una captura de rostro para realizar la verificación. | |
Realiza una verificación de usuarios reales en el modo 2, con un objeto moviéndose en pantalla. | |
Permite la detección de rostro en una imagen. | |
Compara una plantilla de imagen con una imagen móvil tomada por el usuario para la verificación. | |
Compara la plantilla de una imagen con una imagen almacenada en un ID para la verificación. | |
Captura una imagen. | |
Realiza una verificación de usuarios reales en el modo 1, con un objeto moviéndose en pantalla. |
Get Status
Con esta función, se obtienen los datos básicos de la Call API.
Configuración del parámetro
Esta función no requiere la configuración de ningún parámetro.
ID de la función
Registro | Valor |
|---|---|
110 | 1 |
Registros de salida
Registro | Descripción | Valor | ||||||
|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||
290 | API Version | Devuelve la versión de la Call API. | ||||||
291 | SDK Version | Devuelve la versión del SDK. | ||||||
292 | License ID | Devuelve el ID de la licencia del SDK. | ||||||
293 | Is Initialized | Devuelve true o false, ya sea que se haya iniciado o no la Call API. |
Face Capture
Con esta función, se obtiene una imagen del rostro apta para ser verificada.
Configuración del parámetro
Con esta función, no es necesario configurar ningún parámetro obligatorio. Lee Registros de entrada para obtener información sobre los parámetros opcionales que puedes configurar.
ID de la función
Registro | Valor |
|---|---|
110 | 2 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Parámetros de captura de rostro | No | Parámetros en formato JSON. Por ejemplo: {
'cameraFacing':'CAMERA_FACING_FRONT',
'cameraPreviewScaleType':'CENTER_INSIDE'
}NotaPara obtener más información sobre los parámetros que puedes usar para esta función, consulta la documentación para desarrolladores de Innovatrics. Ten en cuenta que este es un sitio de documentación de terceros. |
391 | ID de la imagen capturada | No | ID donde está almacenada la imagen capturada. Por defecto, el ID es «faceCapture». |
392 | Porcentaje de compresión | No | Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. |
393 | Proveedores de calidad | No | Lista de proveedores de calidad separados por comas. Si deseas agregar nuevos proveedores de calidad, debes agregar POSITION, PROXIMITY, LIGHT y FACE_CONFIDENCE. |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
|
Liveness Check 2
Mediante esta función, se lleva a cabo una verificación de usuarios reales en el segundo modo, donde hay un objeto en movimiento o que desaparece en pantalla.
Configuración del parámetro
Con esta función, no es necesario configurar ningún parámetro obligatorio. Lee Registros de entrada para obtener información sobre los parámetros opcionales que puedes configurar.
ID de la función
Registro | Valor |
|---|---|
110 | 3 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Parámetros de la verificación de usuarios reales | No | Parámetros en formato JSON. Por ejemplo: {
'cameraFacing':'CAMERA_FACING_FRONT',
'cameraPreviewScaleType':'CENTER_INSIDE'
}NotaPara obtener más información sobre los parámetros que puedes usar para esta función, consulta la documentación para desarrolladores de Innovatrics. Ten en cuenta que este es un sitio de documentación de terceros. |
391 | ID de la imagen capturada | No | ID donde está almacenada la imagen capturada. Por defecto, el ID es «livenessCheck2». |
392 | Lista de ID para cada una de las imágenes capturadas del segmento. | No | Este string contiene los ID donde se almacenan las imágenes para todos los segmentos. Los ID se separan con comas. Por defecto, los ID que se usan son: livenessCheck21, livenessCheck22, livenessCheck23, livenessCheck24, livenessCheck25, livenessCheck26, livenessCheck27. |
393 | Lista de segmentos | No | Este string contiene una lista de los segmentos que se usan durante las verificaciones de usuarios reales, separados con comas. Los posibles segmentos que se usarán son: TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT y BOTTOM_RIGHT. |
394 | Segmentos mínimos | No | Valor numérico entre 4 y 7 que determina la cantidad de segmentos que deben estar disponibles después de la verificación de usuarios reales para que esta se considere válida. El número por defecto es 4, que es el valor mínimo. |
395 | Porcentaje de compresión | No | Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||||||||||||||||||
290 | Puntaje de verificación de usuarios reales |
Face Detector
Esta función permite la detección de un rostro en una imagen.
Configuración del parámetro
Con esta función, no es necesario configurar ningún parámetro obligatorio. Lee Registros de entrada para obtener información sobre los parámetros opcionales que puedes configurar.
ID de la función
Registro | Valor |
|---|---|
110 | 4 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Cantidad máxima de rostros que se detectarán | No | El número por defecto es 5 y el número máximo es 10. |
391 | ID que almacena la imagen que se analizará. | No | El ID por defecto es «documentAutocapture». |
Registros de salida
Registro | Descripción | Valor | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||
290 | JSON que contiene los datos de un rostro detectado en una imagen. | <<JSONObject>>. Al final del archivo JSON, hay un campo «image identifier» desde el que puedes obtener el ID donde se almacena la imagen analizada. |
Nota
Si se detectan más rostros en la imagen, los resultados se almacenarán en un parámetro de salida que va entre el 291 y el 299. Si no se detecta ningún rostro, el resultado será la respuesta 012, como se muestra en la tabla anterior.
Template Verifier
Con esta función, se compara una plantilla ya almacenada en el dispositivo con una imagen recién capturada del usuario para su verificación.
Configuración del parámetro
Con esta función, no es necesario configurar ningún parámetro obligatorio. Lee Registros de entrada para obtener información sobre los parámetros opcionales que puedes configurar.
ID de la función
Registro | Valor |
|---|---|
110 | 5 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | ID de la plantilla almacenada | Por defecto, el ID es «livenessCheck2Template». |
Por defecto, el valor de la compresión de imágenes dentro de esta función es 70 y no puede modificarse.
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||||||||||
290 | Puntaje de verificación |
La imagen capturada que se comparará con la plantilla para la verificación se guardará en el token «templateVerifier» de la app.
Face Image Verifier
Con esta función, se compara una plantilla ya almacenada en el dispositivo con una imagen almacenada en otro ID de la app.
Configuración del parámetro
Con esta función, no es necesario configurar ningún parámetro obligatorio. Lee Registros de entrada para obtener información sobre los parámetros opcionales que puedes configurar.
ID de la función
Registro | Valor |
|---|---|
110 | 6 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | ID de la plantilla almacenada | Por defecto, el ID es «livenessCheck2Template». | |
391 | ID de la imagen que se comparará con el ID de la plantilla. | Por defecto, el ID es «faceImageVerifier». |
Registros de salida
Registro | Descripción | Valor | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||||
290 | Puntaje de verificación |
Document Autocapture
Esta función se usa para capturar y almacenar la imagen de un documento.
Configuración del parámetro
Con esta función, no es necesario configurar ningún parámetro obligatorio. Lee Registros de entrada para obtener información sobre los parámetros opcionales que puedes configurar.
ID de la función
Registro | Valor |
|---|---|
110 | 7 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | ID de la imagen capturada | Por defecto, el ID es «documentAutocapture». | |
391 | Etapa de análisis de documentos | El valor por defecto es 0. Posibles valores: 0: Sin encabezado. 1: Encabezado con una ayuda visual para capturar el anverso del documento. 2: Encabezado con una ayuda visual para capturar el reverso del documento. | |
392 | Porcentaje de compresión | Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
|
Liveness Check
Mediante esta función se lleva a cabo una verificación de usuarios reales en el modo 1, donde hay un objeto en movimiento o que desaparece en pantalla.
Configuración del parámetro
Con esta función, no es necesario configurar ningún parámetro obligatorio. Lee Registros de entrada para obtener información sobre los parámetros opcionales que puedes configurar.
ID de la función
Registro | Valor |
|---|---|
110 | 8 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Parámetros de la verificación de usuarios reales | Parámetros en formato JSON. Por ejemplo: {
'cameraFacing':'CAMERA_FACING_FRONT',
'cameraPreviewScaleType':'CENTER_INSIDE'
}NotaPara obtener más información sobre los parámetros que puedes usar para esta función, consulta la documentación para desarrolladores de Innovatrics. Ten en cuenta que este es un sitio de documentación de terceros. | |
391 | Lista de ID para cada una de las imágenes capturadas del segmento. | Este string contiene los ID donde se almacenan las imágenes para todos los segmentos. Los ID se separan con comas. Por defecto, los ID que se usan son: livenessCheck21, livenessCheck22, livenessCheck23, livenessCheck24, livenessCheck25, livenessCheck26, livenessCheck27. | |
392 | Lista de segmentos | Este string contiene una lista de los segmentos que se usan durante las verificaciones de usuarios reales, separados con comas. Los posibles segmentos que se usarán son: TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT y BOTTOM_RIGHT. | |
393 | Segmentos mínimos | Valor numérico entre 4 y 7 que determina la cantidad de segmentos que deben estar disponibles después de la verificación de usuarios reales para que esta se considere válida. El número por defecto es 4, que es el valor mínimo. | |
394 | Porcentaje de compresión | Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||||||||||||||||||
290 | Puntaje de verificación de usuarios reales |