Actualización de plantilla de usuario

/updateUserTemplate

El servicio permite la actualización de la plantilla biométrica asociada a un usuario específico. Su función principal es sincronizar la plantilla facial más reciente del usuario almacenada en el repositorio de datos del cliente con una nueva plantilla registrada para el usuario.

Funcionalidad

  • userId: Identificador único para el usuario, persistido y asociado con la plantilla biométrica correspondiente (oldRegisteredTemplateRaw). Necesita tener al menos dos dígitos.

  • image (Opcional): Imagen en formato Base64 obtenida del registro civil para autenticación. Se vuelve obligatoria si no se proporciona la plantilla biométrica registrada (registeredTemplateRaw).

  • oldRegisteredTemplateRaw: Plantilla actualmente registrada asociada al userId.

  • registeredTemplateRaw: Nueva plantilla a asociar con el userId. Debe persistirse para autenticaciones futuras.

Solicitud:

bash

curl --location '{IDENTITY_API_BASE_URL}/services/updateUserTemplate' \
--header 'x-api-key: {API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
    "userId": "001",
    "oldRegisteredTemplateRaw": "BAIBAQFpWL...",
    "newRegisteredTemplateRaw": "BAIBAQG0NRm0d...",
    "tracking": {
        "extraData": "BQABAQG2gBNjuHN...",
        "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
    }
}'

Parámetros de la solicitud:

Parámetro

Tipo (Contenido)

Requerido

Descripción

userId

String

Sí

Identificador único para el usuario. Debe persistirse y asociarse con la plantilla biométrica correspondiente. Necesita tener al menos dos dígitos.

oldRegisteredTemplateRaw

String (Base64)

Sí

Plantilla actualmente registrada asociada al userId.

newRegisteredTemplateRaw

String (Base64)

Sí

Nueva plantilla a asociar con el userId. Debe persistirse para autenticaciones futuras.

extraData

String (Base64)

No

Token generado por el SDK móvil/web. Contiene información de seguimiento tokenizada.

operationId

String (Base64)

No

Identificador de operación generado por el SDK móvil/web.

Ejemplo de Respuesta:

json

Campos de la respuesta:

Identificador

Tipo

Descripción

timestamp

String

Marca de tiempo (UTC) de la respuesta en el formato: YYYY-MM-DDThh:mm:ss.SSSZ

transactionId

String

Identificador de transacción asociado a la solicitud procesada por la API.

serviceResultCode

Integer

Código que indica el resultado general de la ejecución del servicio. Ver Tabla 1 - Código de Resultado del Servicio

serviceResultLog

String

Campo descriptivo del resultado de la ejecución cuando hay un error o excepción. Si es exitoso, indica la descripción del código de resultado.

PreviousListas negras de usuariosNextSeguridad y cumplimiento

Last updated