Todos los productos
Search
Centro de documentos

ID Verification:CheckResult

Última actualización: Oct 26, 2026

This topic describes how to query authentication results using the CheckResult API operation.

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.

    Importante

    El 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:

    Nota
    • Ventajas 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.com

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

    Indonesia

    • 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

    Asia Pacific SE 3 (Kuala Lumpur)

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

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

Depuración e integración en línea

Nota

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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

faceQuality, faceOcclusion, faceAge, faceGender, ExtInfo.procedurePriority

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: devolver

  • N: no devolver (valor predeterminado)

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: la autenticación se aprobó.

  • N: la autenticación no se aprobó.

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.

{
  "faceAttack": "N",
  "faceImg": "/9j/4AAQSkZJRgABAQAAAQqviV6oakp8...",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

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.

{
  "procedurePriority": "keep"
}

Result.ExtFaceInfo

Nombre

Tipo

Descripción

Ejemplo

faceImg

String

Imagen facial en vivo en formato Base64. Se devuelve únicamente cuando IsReturnImage=Y y el escaneo facial se completa correctamente.

Formato Base64

docVideoUrl

String

URL de descarga de OSS para el video de evidencia. Este campo se devuelve únicamente cuando el parámetro DocVideo en InitializeV2 se establece en Y y el video se carga correctamente. La URL tiene una vigencia de 15 minutos. Puede consultarla varias veces durante los 30 minutos posteriores a la autenticación. Después de ese tiempo, el video se elimina y no se puede recuperar.

https://aliyun-cloudauth.oss-aliyuncs.com/.webm

faceAttack

String

Indica si se detectó un ataque de suplantación de presencia:

  • Y: sí

  • N: no

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.

  • Face Guard es un servicio de pago. Para más información, consulte Billing overview.

  • Este token tiene una vigencia de 7 días y no es único.

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:

  • gender: género de la entidad principal. Un valor de 1 indica masculino y 0 indica femenino.

  • glasses: indica si la entidad principal usa lentes. Un valor de 1 indica que se detectaron lentes y 0 que no.

  • hat: indica si la entidad principal usa sombrero o gorra. Esto incluye pañoletas o velos. Un valor de 1 indica que se detectó un sombrero y 0 que no.

  • mask: indica si la entidad principal usa cubrebocas. Un valor de 1 indica que se detectó un cubrebocas y 0 que no.

  • tattoo: indica si la entidad principal tiene un tatuaje visible. Un valor de 1 indica que se detectó un tatuaje y 0 que no.

  • smoking: indica si la entidad principal está fumando. Un valor de 1 indica que se detectó que fuma y 0 que no.

  • others: indica si hay personas distintas a la entidad principal. Un valor de 1 indica que se detectaron otras personas y 0 que no.

  • env: entorno de la entidad principal, como oficina, fábrica, hospital o vehículo. Actualmente, el sistema admite devolver office, hospital, factory, vehicle u other.

  • expression: indica si la entidad principal muestra una expresión exagerada. Una expresión exagerada es un gesto facial intenso, distinto de un estado natural o tranquilo. Un valor de 1 indica que se detectó una expresión exagerada y 0 que no.

  • age: edad de la entidad principal en años.

{
        gender: 1,
        glasses: 0,
        hat: 1,
        mask: 1,
        tattoo: 0,
        smoking: 0,
        others: 1,
        env: "office",
        expression: 1,
        age: 16
}

Result.ExtInfo

Campo

Tipo

Descripción

procedurePriority

String

Método real de degradación para la autenticación H5 móvil:

  • keep: sin degradación

  • url: degradación mediante una URL

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:

  1. Solicite al usuario que desinstale cualquier software o complemento de múltiples instancias, clonación o entorno virtual del dispositivo. Luego, pida que reintente tras restaurar el entorno de seguridad original del equipo.

  2. Compruebe si el nombre de paquete utilizado corresponde a un paquete de demostración de prueba. En ese caso, cámbielo por el nombre de paquete de producción para evitar que la política de seguridad del proyecto o del servicio lo bloquee.