API information
Operación de API: CheckResult
Método de solicitud: HTTPS POST
-
Description: Cuando el servidor recibe una devolución de llamada que indica que la autenticación finalizó, llame a esta API para obtener el estado y la información correspondientes. Esta devolución de llamada se envía cuando el código de resultado del cliente es 1001 o 1002. Para más información, consulte Native SDK client result codes and sub-codes.
ImportanteEl servicio ID Verification almacena los resultados de verificación durante 30 días de forma predeterminada. Consúltelos dentro de este periodo, ya que después se eliminan automáticamente.
-
Límite de QPS: cada API tiene su propio límite de QPS. Para más información, consulte QPS limits of ID Verification server-side APIs.
-
Endpoint del servicio:
NotaVentajas del acceso por red interna: 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 la estabilidad.
Optimización del acceso desde el extranjero: los entornos de red internacionales suelen ser complejos. Consulte Optimize server network latency para ajustar su integración y reducir la latencia de red y los errores en las solicitudes.
Asia Pacific SE 1 (Singapore)
Endpoint público:
cloudauth-intl.ap-southeast-1.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
Indonesia
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
Asia Pacific SE 3 (Kuala Lumpur)
Endpoint público:
cloudauth-intl.ap-southeast-3.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com
Depuración e integración en línea
Antes de depurar e integrar, lea el documento Use OpenAPI para aprender a llamar a las API en la plataforma OpenAPI y obtener el SDK.
Puede probar esta operación de API directamente en OpenAPI Explorer, y generar código de ejemplo del SDK.
Notas de integración
Almacenamiento de TransactionId: TransactionId es un identificador confiable en el servidor para un registro de autenticación. Debe vincularlo con su identificador de negocio y almacenarlo de forma persistente en el App Server.
Periodo de retención de registros: los registros de resultados de autenticación se almacenan durante 30 días de forma predeterminada y luego se eliminan automáticamente. Consulte los resultados dentro de este periodo y guarde la información obligatoria conforme a las normativas aplicables.
Cumplimiento normativo en la obtención y retención de video: el video se devuelve únicamente cuando la función correspondiente está habilitada y la autenticación se completa correctamente. La URL de descarga del video de evidencia tiene una vigencia de 15 minutos. El video original se elimina automáticamente 30 minutos después de finalizar la autenticación. Si su negocio requiere conservar el video, descárguelo de inmediato y cumpla estrictamente con los requisitos locales de privacidad y protección de datos.
Obtención de imágenes: la imagen de autenticación se devuelve solo cuando IsReturnImage se establece en Y y la verificación de presencia facial se completa correctamente. Dado que los datos codificados en Base64 ocupan mucho espacio, mantenga este parámetro con su valor predeterminado N si no necesita mostrar ni conservar la imagen.
Estado de la API frente al resultado de autenticación: un valor Code igual a Success indica únicamente que la operación de API se llamó correctamente. El resultado final de la autenticación depende de los campos Result.Passed y Result.SubCode.
Solución de problemas de autenticación fallida: si Passed es N, analice los campos SubCode y ExtFaceInfo para determinar la causa del error.
Distribución de campos
Las integraciones con App SDK y Web SDK utilizan la misma operación de API CheckResult y los mismos parámetros de consulta. La estructura principal del resultado de autenticación es consistente. Las diferencias principales radican en los campos de extensión de ExtFaceInfo y en la información de respaldo para H5 móvil.
|
Categoría |
Campo |
Descripción |
|
Salidas compartidas |
Respuesta común, resultado de autenticación |
Se devuelven en ambos modos de integración. Su retorno depende del flujo de autenticación y de la configuración de InitializeV2. |
|
Específicos de Web SDK |
|
Calidad facial, oclusión, edad, género y la política de respaldo aplicada en el cliente web. |
|
Específicos de la aplicación |
Ninguna |
Ninguna |
Request parameters
Campo | Tipo | Obligatorio | Descripción | Ejemplo |
MerchantBizId | String | Sí | Identificador de negocio único del comerciante, compuesto por 32 letras y números. Debe coincidir con el valor utilizado en la solicitud InitializeV2. | e0c34a77f5ac40a5aa5e6ed20c35**** |
TransactionId | String | Sí | Identificador de autenticación único que devuelve una llamada exitosa a la API init. Para evitar alteraciones, obtenga siempre este valor desde su almacenamiento en el servidor y no confíe en el valor enviado desde el cliente. | hksb7ba1b28130d24e015d6**** |
IsReturnImage | String | No | Indica si se devuelven las imágenes de autenticación. Si el paquete incluye un certificado, también se devuelve la imagen del certificado.
| Y |
Response data
Nombre | Tipo | Descripción | Ejemplo | |
HTTP Status Code | Integer | Código de estado HTTP. | 200 | |
HTTP Body | RequestId | String | Identificador de la solicitud, utilizado para solucionar problemas. | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Code | String | Código de retorno del servidor. Para más información, consulte Server-side HTTP status codes. | Success | |
Message | String | Descripción detallada del código de retorno. | success | |
Result.Passed | String | Resultado final de la autenticación. Valores válidos:
| Y | |
Result.SubCode | String | Descripción del resultado de autenticación. Para más información, consulte Result.SubCode authentication result sub-codes. | 200 | |
Result.ExtFaceInfo | String | Resultados de la verificación de presencia facial. Para más información, consulte Result.ExtFaceInfo. | | |
Result.ExtInfo | String | Información adicional de autenticación, que incluye principalmente los datos reales de respaldo para H5 móvil. Para más información, consulte Result.ExtInfo. | | |
Result.ExtFaceInfo
Nombre | Tipo | Descripción | Ejemplo |
faceImg | String | Imagen facial en vivo en formato Base64. Se devuelve únicamente cuando | Formato Base64 |
docVideoUrl | String | URL de descarga de OSS para el video de evidencia. Este campo se devuelve únicamente cuando el parámetro | https://aliyun-cloudauth.oss-aliyuncs.com/.webm |
faceAttack | String | Indica si se detectó un ataque de suplantación de presencia:
| N |
faceAttackScore (Obsoleto) | Double | Puntuación de riesgo de ataque de presencia, con un rango de 0 a 100. El riesgo de ataques de presencia ahora lo determina un modelo de lenguaje grande (LLM), por lo que el concepto de puntuación de riesgo ya no aplica. Este campo está fuera de servicio. | 80 |
guardRiskScore | Double | Puntuación de riesgo del dispositivo, con un rango de 0 a 100. Una puntuación más alta indica un mayor riesgo del dispositivo. | 90 |
deviceToken | String | DeviceToken para Face Guard. Se devuelve cuando el módulo Face Guard está completamente integrado y permite consultar las operaciones de API del servidor de Face Guard para obtener detalles sobre el riesgo del dispositivo.
| e0c34a77f5ac40a5aa5e6ed20c35**** |
faceAttributeInfo | String | Detecta los atributos faciales del rostro principal en una imagen de entrada. El rostro principal es el más grande, nítido y cercano a la cámara. Los resultados de detección se devuelven como una cadena que puede utilizar para tomar decisiones sobre el contenido. Los campos devueltos se definen de la siguiente manera:
| |
Result.ExtInfo
Campo | Tipo | Descripción |
procedurePriority | String | Método real de degradación para la autenticación H5 móvil:
|
Result.SubCode authentication result sub-codes
Código de error | Facturación de registros de autenticación | Descripción y sugerencias |
200 | Sí | La autenticación se aprobó. |
205 | Sí | [Ataque de presencia] Se detectó un riesgo durante la verificación de presencia. |
206 | Sí | [Ataque de presencia] Limitado por la política de negocio. Cuando el modo seguro está habilitado, se comprueba la seguridad del dispositivo y del entorno. Si se detecta un riesgo potencial, la autenticación falla. Para solucionar y gestionar este problema, siga estos pasos:
|