Todos los productos
Search
Centro de documentos

ID Verification:CheckResult

Última actualización: Oct 23, 2026

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

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.

    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.

  • Endpoints 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 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.com

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

    Indonesia (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

    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 depurar esta API directamente en OpenAPI Explorer y generar un ejemplo de código del SDK para esta API.

Notas de uso

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

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

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

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

  5. Estado de la API frente al resultado de autenticación: una respuesta con Code=Success solo indica que la llamada a la API se ejecutó correctamente. El resultado final de la autenticación lo determinan los campos Result.Passed y Result.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 ExtFaceInfo (incluye resultados de detección de vitalidad facial, comparación de rostros o búsqueda 1:N, y registro facial)

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

Específico de Web SDK

procedurePriority

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

  • N: no devolver (valor predeterminado)

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

  • N: Con errores

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.

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

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.

{
  "procedurePriority": "keep"
}

Result.ExtFaceInfo

Parámetro

Tipo

Descripción

Ejemplo

faceImg

String

La imagen del rostro en vivo en formato Base64. Se devuelve solo cuando IsReturnImage=Y y el escaneo facial se completa correctamente.

Formato Base64

docVideoUrl

String

La URL de descarga de OSS para el video de evidencia. Solo se devuelve cuando el parámetro DocVideo en InitializeV2 se establece en Y y el video se carga correctamente. La URL es válida durante 15 minutos. Puede consultarla varias veces dentro de los 30 minutos posteriores a la finalización de la autenticación. Después de 30 minutos, 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 vitalidad:

  • Y: sí

  • N: no

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.

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

  • Este token es válido durante 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. Puede usar esta cadena para tomar decisiones sobre el contenido.

Los campos devueltos se definen de la siguiente manera:

  • gender: el 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. 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: el 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 tiene una expresión exagerada. Una expresión exagerada es un gesto facial intenso que difiere de un estado natural o tranquilo. Un valor de 1 indica que se detectó una expresión exagerada y 0 que no.

  • age: la 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
}

faceComparisonScore

Double

El resultado de la comparación facial se devuelve cuando VerifyModel=1/2. La puntuación de comparación va de 0 a 100. El umbral predeterminado del sistema es 90. También puede personalizar la decisión según los requisitos de su negocio.

90

duplicateFace

List

Devuelve el resultado de la búsqueda de rostros duplicados cuando VerifyModel es 0 o 2 y se encuentra un rostro similar.

Los campos devueltos se definen de la siguiente manera:

  • faceGroupCode: el código del grupo de rostros que contiene el rostro similar.

  • faceId: el ID del rostro similar.

  • merchantUserId: el ID de usuario único para un rostro similar.

  • score: la puntuación de similitud del rostro.

[
      {
        "faceGroupCode": "sg7****uzt",
        "faceId": "f5a921*******9e792ec84c8f0ca592a"
        "merchantUserId":"face0005",
        "score":93.26
      }
    ]

faceRegistrationResult

Integer

Resultado del registro facial (se devuelve cuando VerifyModel=0/2):

  • 0: error en el registro debido a un problema con la imagen del rostro.

  • 1: registro correcto.

  • 2: error en el registro porque no se cumplieron las condiciones de registro automático.

  • 3: error en el registro porque el usuario ya existe.

  • 4: registro correcto y la imagen del rostro se actualizó correctamente (esto ocurre cuando una entrada cumple las condiciones de registro automático, pero tiene un MerchantUserId duplicado y UpdateFaceIfUserExists se estableció en Y).

1

faceRegistrationId

String

El ID del rostro registrado, que se devuelve cuando VerifyModel=0/2, AutoRegistration=0 y el registro se completa correctamente.

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:

  • keep: sin degradación

  • url: degradación mediante una URL

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:

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

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

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 Result.ExtFaceInfo.duplicateFace para gestionar los riesgos de registro duplicado o suplantación de identidad.