Saltar al contenido principal
La sección de ejemplo de respuesta de callback muestra respuestas de ejemplo que los usuarios pueden esperar de las interacciones con la API, proporcionando claridad sobre la estructura y el formato de respuesta. Al utilizar estos ejemplos, los usuarios pueden desarrollar y probar sus integraciones de manera efectiva, asegurando una comunicación fluida entre su aplicación y la API. Esta sección sirve como un recurso valioso para mejorar el proceso de integración y optimizar los esfuerzos de desarrollo.

​
Ejemplos de respuesta

{
  "statusCode": 200,
  "apiType": "id_live_doc",
  "transactionId": "{{transactionId}}",
  "engineVersion": "{{engineVersion}}",
  "result": {
    "screenReplay": {
      "liveness_score": 99
    },
    "paperPrinted": {
      "liveness_score": 82
    },
    "replacePortraits": {
      "liveness_score": 100
    }
  }
}

​
Descripción de campos de respuesta

​
Campos de respuesta exitosa

FieldTypeDescription
statusCodenumberCódigo de estado del resultado de la solicitud API
apiTypestringIdentificador del tipo de API
transactionIdstringIdentificador único de cada solicitud
engineVersionstringVersión del motor de liveness utilizada en la solicitud
resultobjectObjeto que contiene el resultado del procesamiento
result.screenReplayobjectObjeto que contiene el resultado del pipeline Screen Replay
result.screenReplay.liveness_scorenumberResultado de liveness score de la verificación Screen Replay
result.paperPrintedobjectObjeto que contiene el resultado del pipeline Paper Printed
result.paperPrinted.liveness_scorenumberResultado de liveness score de la verificación Paper Printed
result.replacePortraitsobjectObjeto que contiene el resultado del pipeline Replace Portraits
result.replacePortraits.liveness_scorenumberResultado de liveness score de la verificación Replace Portraits

​
Campos de respuesta de error

FieldTypeDescription
statusCodenumberCódigo de estado del resultado de la solicitud API
apiTypestringIdentificador del tipo de API
transactionIdstringIdentificador único de cada solicitud
engineVersionstringVersión del motor de liveness utilizada en la solicitud
errorCodenumberIdentifica el error específico para facilitar el diagnóstico
messagestringDescripción breve del error

​
Códigos de error

Error CodeDescription
1003Fail to process data
1009Fail to analyze document

​
Cómo interpretar los liveness scores

​
Rangos de puntuación

  • 0-30: Alto riesgo de falsificación
  • 31-60: Riesgo medio de falsificación
  • 61-80: Bajo riesgo de falsificación
  • 81-100: Riesgo muy bajo de falsificación

​
Explicación de pipelines

​
Detección de Screen Replay

Detecta si la imagen enviada es una captura de pantalla o una reproducción digital en lugar de un documento físico.

​
Detección de Paper Printed

Identifica si el documento es una versión impresa o fotocopiada en lugar del original.

​
Detección de Replace Portraits

Comprueba si la imagen facial del documento ha sido alterada o reemplazada digitalmente.

​
Directrices de integración

​
Manejo de respuestas

  1. Verificar código de estado: Siempre verifique primero el código de estado de la respuesta
  2. Almacenar Transaction ID: Guarde el transaction ID como referencia
  3. Evaluar puntuaciones: Revise los liveness scores de cada pipeline
  4. Manejo de errores: Implemente un manejo adecuado de errores para solicitudes fallidas

​
Mejores prácticas

  • Registro de logs: Registre todas las respuestas para facilitar la depuración
  • Lógica de reintentos: Implemente lógica de reintentos ante fallos transitorios
  • Validación: Valide la estructura de la respuesta antes de procesarla
  • Seguridad: Garantice el manejo seguro de datos sensibles de documentos