API information
Nombre de la operación: 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 de autenticació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.
-
Endpoints 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 pueden 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 (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
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 depurar esta API directamente en OpenAPI Explorer y generar un ejemplo de código del SDK para esta API.
Notas de uso
Requisitos de almacenamiento de TransactionId: TransactionId es el identificador confiable del servidor para un registro de autenticación. Debe vincularlo con su ID de negocio de comerciante y almacenarlo de forma persistente en su servidor.
Retención de registros: de forma predeterminada, los registros de resultados de autenticación se conservan durante 30 días y luego se eliminan automáticamente. Consulte los resultados dentro de este periodo de retención y almacene los datos necesarios según sus requisitos de cumplimiento.
Recuperación de videos y cumplimiento: solo se devuelve un video de evidencia si la función correspondiente está habilitada y el proceso de autenticación finaliza correctamente. La URL de descarga del video de evidencia es válida durante 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 las normativas locales de privacidad y datos.
Directrices para recuperar imágenes: dado que los datos codificados en Base64 son voluminosos, deje este parámetro como N (valor predeterminado) si no necesita la imagen.
Estado de la API frente al resultado de autenticación: una respuesta con
Code=Successsolo indica que la llamada a la API se ejecutó correctamente. El resultado final de la autenticación lo determinan los camposResult.PassedyResult.SubCode.
Distribución de campos
Los métodos de integración mediante App SDK y Web SDK comparten los mismos parámetros de solicitud y la estructura principal de respuesta. Ambos incluyen resultados de detección de vitalidad facial, comparación de rostros (o búsqueda 1:N) y registro facial. La única diferencia es que el método con Web SDK también devuelve información sobre la degradación de la autenticación.
|
Categoría |
Campo |
Descripción |
|
Salida compartida |
Parámetros de respuesta comunes, resultado de autenticación y |
Se puede devolver en ambos modos de integración. La devolución de estos campos depende del flujo de autenticación y de la configuración de |
|
Específico de Web SDK |
|
Si ocurre una degradación de compatibilidad, este campo devuelve la estrategia de degradación utilizada. |
|
Específico de App SDK |
Ninguna |
Ninguna |
Request parameters
Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |
MerchantBizId | String | Sí | Un ID 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í | El identificador de autenticación único que devuelve una llamada exitosa a la API de inicialización. Para evitar alteraciones, obtenga siempre este valor desde el almacenamiento de su servidor y no confíe en el valor enviado desde el cliente. | hksb7ba1b28130d24e015d6**** |
IsReturnImage | String | No | Especifica si se devuelve la imagen del rostro:
| Y |
Response data
Parámetro | Tipo | Descripción | Ejemplo | |
Código de estado HTTP | Integer | El código de estado HTTP. | 200 | |
Cuerpo HTTP | RequestId | String | El ID de la solicitud. | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Code | String | El código de respuesta de la API. Para más información, consulte Server-side HTTP status codes. | Success | |
Message | String | Una descripción del código de respuesta. | success | |
Result.Passed | String | El resultado final de la autenticación:
| Y | |
Result.SubCode | String | Una descripción del resultado de autenticación. Para más información, consulte Result.SubCode authentication result subcodes. | 200 | |
Result.ExtFaceInfo | String | Resultados relacionados con la verificación de vitalidad facial. Para más información, consulte Result.ExtFaceInfo. | | |
Result.ExtInfo | String | Otra información de autenticación, que incluye principalmente detalles sobre la degradación real en integraciones H5 móviles. Para más información, consulte Result.ExtInfo. | | |
Result.ExtFaceInfo
Parámetro | Tipo | Descripción | Ejemplo |
faceImg | String | La imagen del rostro en vivo en formato Base64. Se devuelve solo cuando | Formato Base64 |
docVideoUrl | String | La URL de descarga de OSS para el video de evidencia. Solo se devuelve cuando el parámetro | https://aliyun-cloudauth.oss-aliyuncs.com/.webm |
faceAttack | String | Indica si se detectó un ataque de suplantación de vitalidad:
| N |
faceAttackScore (Obsoleto) | Double | La puntuación de riesgo de ataque de vitalidad, con un rango de 0 a 100. El riesgo de ataques de vitalidad 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 | La 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 | El DeviceToken para Face Guard. Se devuelve cuando el módulo Face Guard está completamente integrado y se puede usar para consultar las operaciones de la API del servidor de Face Guard y obtener detalles del 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. Puede usar esta cadena para tomar decisiones sobre el contenido. Los campos devueltos se definen de la siguiente manera:
| |
faceComparisonScore | Double | El resultado de la comparación facial se devuelve cuando | 90 |
duplicateFace | List | Devuelve el resultado de la búsqueda de rostros duplicados cuando Los campos devueltos se definen de la siguiente manera:
| |
faceRegistrationResult | Integer | Resultado del registro facial (se devuelve cuando
| 1 |
faceRegistrationId | String | El ID del rostro registrado, que se devuelve cuando | f5a9219aefd6***c84c8f0ca592a |
Result.ExtInfo
Parámetro | Tipo | Descripción |
procedurePriority | String | El método de degradación real para la autenticación H5 móvil:
|
Result.SubCode subcodes
Código secundario | Facturado | Descripción |
200 | Sí | Autenticación aprobada. |
205 | Sí | [Ataque de vitalidad] Se detectó un riesgo durante la comprobación de vitalidad. |
206 | Sí | [Ataque de vitalidad] Limitado por la política del negocio. Cuando se habilita el modo seguro, se comprueba la seguridad del dispositivo y del entorno. Si se detecta un riesgo potencial, la autenticación falla. Puede solucionar y gestionar este problema de la siguiente manera:
|
204 | Sí | [Resultado de verificación 1:1] Esto puede deberse a que el usuario no es la misma persona o a que la calidad de la imagen del rostro es deficiente. |
233 | Sí | Resultado de búsqueda 1:N: se detectaron rostros similares. Utilice la información en |