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.
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:
NotaUna 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.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
Asia Pacific SE 5 (Jakarta)
Endpoint público:
cloudauth-intl.ap-southeast-5.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com
China (Hong Kong)
Endpoint público:
cloudauth-intl.cn-hongkong.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
Depuración e integración en línea
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. | |
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:
|
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: [
] |
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:
|
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:
|
InterruptPageEn | String | No | Código en inglés de la página donde se interrumpió el proceso de autenticación. Valores válidos:
|
VerifyErrorCode | String | No | Código de error de la interrupción de la autenticación. Valores válidos:
|
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:
Nota La duración se mide desde que se renderiza una página hasta que el usuario navega a otra o la cierra. | |
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 | 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. |