Skip to main content

El Objeto de Vivacidad de Documento

Descripción​

El objeto de Vivacidad de Documento representa el resultado de todas las validaciones realizadas sobre un documento enviado como imagen en base64. Este objeto contiene información sobre diversas verificaciones anti-fraude, incluyendo detección de Reproducción en Pantalla, Copia Impresa, Sustitución de Retrato y Manipulación Digital.

Atributos​

client​

Tipo: string (reference id)
Requerido: Sí

Referencia al cliente propietario de este registro de vivacidad de documento.

appRegistration​

Tipo: string (reference id)
Requerido: Sí

Referencia al registro de aplicación asociado con esta validación de vivacidad de documento.

imageSaved​

Tipo: Boolean
Requerido: No
Predeterminado: false

Indica si la imagen del documento procesado ha sido guardada en almacenamiento.

imageUrl​

Tipo: String
Requerido: No
Predeterminado: ""

URL donde se almacena la imagen del documento procesado (cuando imageSaved es true).

status​

Tipo: String
Requerido: Sí

El estado actual de la validación de vivacidad de documento. Puede ser:

  • "new" - Solicitud de validación creada pero aún no procesada (predeterminado)
  • "processing" - Documento en análisis
  • "completed" - Validación completada con éxito
  • "failed" - La validación falló

validationResults​

Tipo: Object
Requerido: No

Contiene los resultados de varias verificaciones:

  • screenReplay - Resultado de detección de reproducción en pantalla
  • printedCopy - Resultado de detección de copia impresa
  • portraitSubstitution - Resultado de detección de sustitución de retrato
  • digitalManipulation - Resultado de detección de manipulación digital

calibrationSettings​

Tipo: Object
Requerido: No

Contiene la configuración de calibración utilizada para la validación:

  • screenReplayCalibration - Nivel de calibración: SOFT, REGULAR, HARD
  • printedCopyCalibration - Nivel de calibración: SOFT, REGULAR, HARD
  • portraitSubstitutionCalibration - Nivel de calibración: SOFT, REGULAR, HARD

validationFlags​

Tipo: Object
Requerido: No

Contiene banderas de configuración de validación:

  • ignoreDocumentCroppedValidation - Bandera booleana para ignorar recorte del documento
  • ignoreColourLessValidation - Bandera booleana para ignorar falta de color

riskScore​

Tipo: Number
Requerido: No

Puntaje de evaluación de riesgo general del documento.

confidence​

Tipo: Number
Requerido: No

Puntaje de confianza para los resultados de validación.

createdAt​

Tipo: Date
Requerido: Sí

Marca de tiempo cuando se creó la validación de vivacidad de documento.

updatedAt​

Tipo: Date
Requerido: Sí

Marca de tiempo de la última actualización de la validación de vivacidad de documento.

completedAt​

Tipo: Date
Requerido: No

Marca de tiempo cuando la validación se completó exitosamente.

Objeto de Ejemplo​

{
  "_id": "document_liveness_123456789",
  "client": "client_123456789",
  "appRegistration": "app_registration_123456789",
  "imageSaved": true,
  "imageUrl": "https://cdn.verifik.co/images/document_123456789.jpg",
  "status": "completed",
  "validationResults": {
    "screenReplay": {
      "passed": true,
      "score": 0.95,
      "details": "No screen replay detected"
    },
    "printedCopy": {
      "passed": true,
      "score": 0.90,
      "details": "No printed copy detected"
    },
    "portraitSubstitution": {
      "passed": true,
      "score": 0.88,
      "details": "No portrait substitution detected"
    },
    "digitalManipulation": {
      "passed": true,
      "score": 0.92,
      "details": "No digital manipulation detected"
    }
  },
  "calibrationSettings": {
    "screenReplayCalibration": "REGULAR",
    "printedCopyCalibration": "REGULAR",
    "portraitSubstitutionCalibration": "REGULAR"
  },
  "validationFlags": {
    "ignoreDocumentCroppedValidation": false,
    "ignoreColourLessValidation": false
  },
  "riskScore": 0.05,
  "confidence": 0.91,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:32:00Z",
    "completedAt": "2024-01-15T10:32:00Z"
}

Características​

  • Identificación única: Cada validación tiene un ID único de referencia
  • Múltiples estados: Soporte para diferentes estados del proceso de validación
  • Validaciones anti-fraude: Cuatro tipos de detección de ataques
  • Configuración de calibración: Niveles SOFT, REGULAR y HARD
  • Banderas de validación: Configuraciones para ignorar recorte y falta de color
  • Puntajes detallados: Puntuaciones de confianza por cada tipo de validación
  • Almacenamiento de imagen: Opción para guardar imágenes en el CDN
  • Evaluación de riesgo: Puntaje general de riesgo del documento
  • Marcas de tiempo completas: Registro de creación, actualización y finalización
  • Información de contexto: Datos de cliente y registro de aplicación