Todos los productos
Search
Centro de documentos

ID Verification:Consulta de registros de autenticación de extremo a extremo

Última actualización: Sep 09, 2026

ID Verification ofrece monitoreo de registros de extremo a extremo. Puede consultar los registros de un proceso de autenticación incompleto mediante su TransactionId. Los resultados le ayudan a analizar las razones del abandono de usuarios. Esta API no genera cargos de facturación.

API

Esta API consulta el registro completo de un proceso de autenticación.

Importante
  • Esta API consulta registros únicamente para soluciones del lado del cliente. No es compatible con soluciones exclusivas del lado del servidor.

  • El SDK del lado del cliente para la autenticación debe ser la versión 1.2.6 o posterior, y el SDK web debe estar en su versión más reciente. Se recomienda utilizar las versiones más recientes de los SDK.

  • Los registros se reportan y cargan de forma asíncrona durante el proceso de autenticación. Para obtener resultados completos, consulte los registros una vez que expire el periodo de validez de 30 minutos del TransactionId.

  • ID Verification almacena los registros durante 30 días de manera predeterminada y luego los elimina automáticamente. Asegúrese de consultar los registros de autenticación dentro de los 30 días posteriores a la finalización del proceso.

  • Nombre de la API: CheckVerifyLog

  • Método de solicitud: POST

  • Protocolo de transporte: HTTPS

  • Endpoints:

    Nota
    • Una red interna es una red de comunicación privada que conecta los productos de Alibaba Cloud dentro de la misma región. Si su servidor de aplicaciones está desplegado en la misma región, utilice el endpoint interno para acceder al servicio ID Verification y mejorar la seguridad y estabilidad.

    • Los distintos planes de producto de ID Verification admiten diferentes regiones, y los datos están aislados entre ellas. Debe usar el endpoint correspondiente a la región de sus datos para acceder a ellos.

    Asia Pacific SE 1 (Singapore)

    • Endpoint público: cloudauth-intl.ap-southeast-1.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    Asia Pacific SE 5 (Jakarta)

    • Endpoint público: cloudauth-intl.ap-southeast-5.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    China (Hong Kong)

    • Endpoint público: cloudauth-intl.cn-hongkong.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

Depuración e integración en línea

Nota

Antes de depurar e integrar, lea el documento Use OpenAPI para aprender a invocar las API en la plataforma OpenAPI y obtener el SDK.

Puede ejecutar esta API en OpenAPI Explorer para depurarla y generar código de ejemplo del SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

MerchantBizId

String

Sí

Identificador de negocio único y personalizable que se utiliza para solucionar problemas. Puede combinar letras y dígitos hasta un máximo de 32 caracteres. Asegúrese de que este identificador sea único.

Nota

Los servidores de Alibaba Cloud no imponen la unicidad de este campo. Para facilitar el seguimiento, le recomendamos encarecidamente garantizar que sea único.

e0c34a77f5ac40a5aa5e6ed20c

TransactionId

String

Sí

Identificador único de todo el proceso de autenticación. La API Initialize devuelve este valor.

80414a5e6ed20c37ac40a7f55a

Parámetros de respuesta

Parámetro

Tipo

Descripción

Ejemplo

RequestId

String

ID de la solicitud.

{
  "RequestId": "A180B706-587F-3F53-9861-8A2E70F802D7",
  "Message": "success",
  "Code": "Success",
  "Result": {
    "Passed": "Y",
    "VerifyStatus": "0",
    "LogStatisticsInfo": "{\"faceOverTimes\":0,\"hasFaceOverTimes\":false,\"hasFacePermissionRefuse\":false,\"hasOcrEdit\":false,\"hasOcrEditOverTimes\":false,\"hasOcrOverTimes\":false,\"hasOcrPermissionRefuse\":false,\"ocrEditOverTimes\":0,\"ocrEditTimes\":0,\"ocrOverTimes\":0,\"pageStayTimeInfo\":{\"LOADING\":\"322\",\"OCR_SCAN\":\"8237\",\"OCR_RESULT\":\"2257\",\"FACE\":\"14687\"}}",
    "InterruptPage": "OCR result editing page",
    "InterruptPageEn": "OCR_RESULT",
    "LogInfo": [
      "2025-04-09 17:27:08 Entered the Loading page",
      "2025-04-09 17:27:08 Loading phase ended",
      "2025-04-09 17:27:08 User entered the OCR page",
      "2025-04-09 17:27:16 OCR authentication phase ended",
      "2025-04-09 17:27:16 User entered the OCR editing page",
      "2025-04-09 17:27:19 OCR editing phase ended",
      "2025-04-09 17:27:19 User entered the liveness detection page",
      "2025-04-09 17:27:33 Liveness detection phase ended"
    ],
    "LogInfoEn": [
      "2025-08-13 18:33:44 LOADING_ENTER",
      "2025-08-13 18:33:45 LOADING_EXIT",
      "2025-08-13 18:33:45 GUIDE_PAGE_SHOW",
      "2025-08-13 18:33:46 GUIDE_PAGE_LEAVE",
      "2025-08-13 18:33:46 OCR_ENTER",
      "2025-08-13 18:33:51 TIME_OUT_ALERT_APPEAR",
      "2025-08-13 18:33:54 TIME_OUT_ALERT_CLOSE",
      "2025-08-13 18:33:54 TIME_OUT_RETRY_BTN",
      "2025-08-13 18:33:59 TIME_OUT_ALERT_APPEAR",
      "2025-08-13 18:34:11 TIME_OUT_ALERT_CLOSE",
      "2025-08-13 18:34:11 TIME_OUT_RETRY_BTN",
      "2025-08-13 18:34:16 TIME_OUT_ALERT_APPEAR",
      "2025-08-13 18:34:17 TIME_OUT_ALERT_CLOSE",
      "2025-08-13 18:34:17 TIME_OUT_EXIT_BTN",
      "2025-08-13 18:34:17 OCR_EXIT"
    ],
    "SubCode": "200",
    "VerifyErrorCode": "1000"
  }
}

Code

String

El return code.

Message

String

Descripción detallada del código de retorno.

Result

Object

Contenido del registro. Consulte la Result table a continuación para conocer los detalles de los parámetros.

Result

Parámetro

Tipo

Obligatorio

Descripción

VerifyStatus

String

Sí

Estado de la autenticación. Valores válidos:

  • 0: autenticación completada

  • 1: autenticación interrumpida

  • 2: autenticación no iniciada

LogInfo

List<String>

No

Detalles del registro de ejecución del SDK, que documentan cronológicamente las interacciones del usuario y los eventos del sistema. Algunos ejemplos de entradas son:

[

  • Marca de tiempo - Ingresó a una página específica

  • Marca de tiempo - Solicitó permiso de cámara

  • Marca de tiempo - Aceptó y luego cerró el permiso de cámara

  • Marca de tiempo - Ingresó a la página de reintento de detección de vida

  • Marca de tiempo - El usuario hizo clic en Retry

  • Marca de tiempo - Inició la detección de vida colorida (solo si está habilitada)

  • Marca de tiempo - Finalizó la detección de vida colorida (solo si está habilitada)

  • Marca de tiempo - El usuario completó el reconocimiento facial del lado del cliente e ingresó a la página de carga

  • Marca de tiempo - Carga completada y salida del SDK

]

LogInfoEn

List<String>

No

Detalles del registro de ejecución del SDK en inglés.

El formato de este campo es el mismo que el de LogInfo.

Passed

String

No

Nota

Este parámetro se devuelve solo cuando VerifyStatus es 0.

Resultado final de la autenticación. Valores válidos:

  • Y: aprobado

  • N: con errores

SubCode

String

No

Nota

Este parámetro se devuelve solo cuando VerifyStatus es 0.

Código detallado del resultado de la autenticación. Para ver la lista de valores posibles, consulte las descripciones de SubCode en la referencia de la API correspondiente a su solución de autenticación.

Nota

Por ejemplo, si utiliza la solución eKYC - Web SDK, consulte las descripciones de SubCode en la referencia de la API eKYC - Web SDK - CheckResult.

InterruptPage

String

No

Última página que visitó el usuario antes de que se interrumpiera el proceso. Valores válidos:

  • Página no iniciada

  • Página de carga

  • Página de guía

  • Página de captura de certificado por OCR

  • Página de edición de resultados de OCR

  • Página de detección de vida

  • Página de entrada de información NFC

  • Página de lectura NFC

InterruptPageEn

String

No

Código en inglés de la página donde se interrumpió el proceso de autenticación. Valores válidos:

  • LOADING

  • GUIDE

  • FACE

  • OCR_SCAN

  • OCR_RESULT

  • NFC_INPUT

  • NFC_READ

VerifyErrorCode

String

No

Código de error de la interrupción de la autenticación. Valores válidos:

  • 1000: el usuario completó el proceso de reconocimiento facial. El resultado de autenticación recomendado es aprobado.

  • 1001: el usuario completó el proceso de reconocimiento facial. El resultado de autenticación recomendado es con errores.

  • 1002: ocurrió un error del sistema.

  • 1003: la inicialización del SDK falló. Compruebe si la hora del cliente es correcta.

  • 1004: ocurrió un error de permiso de cámara.

  • 1005: ocurrió un error de red.

  • 1006: el usuario salió del proceso.

  • 1007: el TransactionId no es válido.

  • 1009: la marca de tiempo del lado del cliente es incorrecta.

  • 1011: el tipo de certificado enviado es incorrecto.

  • 1012: falta información clave en el certificado reconocido o la verificación de formato falló.

  • 1013: la calidad de la imagen es deficiente.

  • 1014: se superó el límite de intentos.

  • 1015: la versión del sistema operativo Android es demasiado antigua.

  • 1016: no se concedió el permiso de cámara.

  • 9999: es probable que el proceso de autenticación se haya interrumpido.

LogStatisticsInfo

String

No

Estadísticas del registro de ejecución del SDK, en formato de cadena JSON. Consulte la LogStatisticsInfo table a continuación para conocer los detalles de los campos.

ExtInfo

String

No

Reservado para extensiones.

LogStatisticsInfo

Parámetro

Tipo

Descripción

Ejemplo

pageStayTimeInfo

Map<String,Long>

Tiempo empleado en cada página, en milisegundos. Las claves del mapa representan las siguientes páginas:

  • LOADING: página de carga

  • GUIDE: página de guía

  • OCR_SCAN: página de OCR

  • OCR_RESULT: página de edición de OCR

  • FACE: página de reconocimiento facial

Nota

La duración se mide desde que se renderiza una página hasta que el usuario navega a otra o la cierra.

{
 "LOADING": "2051",
 "OCR_SCAN": "127238",
 "OCR_RESULT": "1897",
 "FACE": "12371"
}

hasFaceOverTimes

Boolean

Indica si se mostró una ventana emergente de reintento durante la detección de vida.

true

faceOverTimes

Long

Número de veces que el usuario hizo clic en Retry durante la detección de vida.

2

hasOcrOverTimes

Boolean

Indica si se reintentó el proceso de OCR.

Este indicador es true si un fallo de verificación del lado del servidor solicitó al usuario capturar y enviar nuevamente la imagen del certificado.

false

ocrOverTimes

Long

Número de veces que el usuario hizo clic en Retry durante la captura del certificado por OCR.

0

hasOcrEdit

Boolean

Indica si el usuario hizo clic para editar la información de los campos en la página de OCR.

true

ocrEditTimes

Long

Número de ediciones de OCR.

El contador aumenta en uno cada vez que el usuario edita y envía la información para su verificación del lado del servidor.

1

hasOcrEditOverTimes

Boolean

Indica si se reintentó el proceso de edición de OCR.

false

ocrEditOverTimes

Long

Número de reintentos de edición de OCR.

0

hasOcrPermissionRefuse

Boolean

Indica si se denegó el permiso de cámara para el OCR.

false

hasFacePermissionRefuse

Boolean

Indica si se denegó el permiso de cámara para la detección de vida.

false

Códigos de retorno

Código de estado HTTP

Code

Descripción del mensaje

200

Success

Solicitud exitosa.

400

MissingParameter

El parámetro no puede estar vacío.

InvalidParameter

Parámetro no válido.

TransactionIdInvalid

ID de transacción no válido.

403

Forbidden.RAMUserAccessDenied

Debe otorgar al usuario de RAM el permiso AliyunAntCloudAuthFullAccess. Para obtener más información, consulte Authorize RAM users to access the service.

Forbidden.AccountAccessDenied

Asegúrese de haber activado ID Verification y de que su cuenta no tenga pagos pendientes.

Throttling.Api

La solicitud a la API se bloqueó debido a limitaciones de tráfico.

404

ProcessNotCompleted

El proceso de autenticación completo no ha finalizado.

500

InternalError

Error interno del sistema. Envíe comentarios a los ingenieros para solucionar el problema.

503

ServiceUnavailable

El servicio no está available. Contacte a los ingenieros para solucionar el problema.