Todos los productos
Search
Centro de documentos

ID Verification:Server-side API operation

Última actualización: Sep 17, 2026

Este tema describe cómo configurar el lado del servidor para FACE_GUARD_PRO.

Información de la API

  • Operación de API: FaceGuardRisk

  • Método de solicitud: POST y GET

  • Protocolo: HTTPS

  • Importante

    La facturación de FACE_GUARD_PRO se realiza por cada consulta exitosa. Se recomienda no consultar repetidamente el mismo Device Token después de una consulta exitosa para evitar cobros duplicados.

  • Límite de QPS: cada API tiene su propio límite de QPS. Para obtener más información, consulte QPS limits of ID Verification server-side APIs.

  • Endpoints globales:

    Nota
    • 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. Esto mejora la seguridad y la estabilidad.

    • Para cumplir con los requisitos de recolección de datos en distintas regiones, Device Helper proporciona sitios de reporte de datos independientes. Los datos están aislados entre estos sitios.

      El cliente especifica el sitio de reporte al establecer CustomUrl y CustomHost. Posteriormente, su servidor debe acceder al endpoint correspondiente al sitio reportado para recuperar la información detallada.

    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

    Asia Pacific SE 5 (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

    US West 1 (Silicon Valley)

    • Endpoint público: cloudauth-intl.us-west-1.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.us-west-1.aliyuncs.com

    Europe Central 1 (Frankfurt)

    • Endpoint público: cloudauth-intl.eu-central-1.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.eu-central-1.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 invocar las API en la plataforma OpenAPI y obtener el SDK.

Puede ejecutar esta API en OpenAPI Explorer para depurarla y generar un código de ejemplo del SDK.

Parámetros de solicitud

Parameter

Type

Required

Description

Example

ProductCode

String

Yes

El código del producto. Establezca este valor como FACE_GUARD_PRO.

FACE_GUARD_PRO

MerchantBizId

String

Yes

Un identificador de negocio único que usted define para solucionar problemas. El valor puede ser una combinación de letras y dígitos de hasta 32 caracteres de longitud. Asegúrese de que el identificador sea único.

e0c34a77f5ac40a5aa5e6ed2****

DeviceToken

String

Yes

El deviceToken obtenido del SDK del cliente.

Tk9SSUQuMS***ZDNmNWY5NzQxOW1o

BizId

String

No

El identificador único de la autenticación de negocio actual. Se utiliza junto con FACE_GUARD_PRO para la verificación durante las consultas.

10000001

Parámetros de respuesta

Nombre

Tipo

Descripción

Ejemplo

RequestId

String

El identificador de la solicitud.

130A2C10-B9EE-4D84-88E3-5384****

Code

String

El código de retorno. Para obtener más información, consulte Server-side HTTP status codes.

Success

Message

String

Esta sección proporciona descripciones detalladas de los códigos de retorno.

success

Result.TransactionId

String

El identificador único de todo el proceso de autenticación.

e0c34a77f5ac40a5aa5e6ed2****

Result.RiskTags

String

Las etiquetas de riesgo del dispositivo. Separe varias etiquetas con una coma ,. Para obtener más información sobre las etiquetas de riesgo del dispositivo y sus significados, consulte Device Guard risk tags.

ROOT,VPN,HOOK

Result.RiskExtends

String

Para obtener más información, consulte Result.RiskExtends.

{
  "code": "Success",
  "message":"success",
  "umid":"07d3295d3d597b425d102a7f********",
  "sip":"198.51.100.1",
  "durationMs" : 4968931,
  "queryCount":1,
  "querySessionCount":1,
  "queryUmidCount":1,
  "platform":"Android"
}

Result.GuardRiskScore

Double

La probabilidad de riesgo del dispositivo predicha por el algoritmo del asistente de dispositivos. Una puntuación más alta indica un mayor riesgo del dispositivo.

Valores válidos: de 0 a 100.

99

Result.RiskExtends

Campo

Significado

Descripción detallada

code

Código de estado del token

  • 200: el token es normal.

  • 401: los datos del token son anómalos.

  • 404: el formato de los datos del token es anómalo.

  • 407: el token ha caducado (válido por 7 días).

  • 408: el token o los datos reportados fueron alterados.

  • 500: ocurrió una excepción desconocida en el token.

message

Mensaje de error del token

El mensaje de error del token. Este campo se completa cuando el código no es 200.

umid

Identificador único del dispositivo

07d3295d3d597b425d102a7f****

platform

Plataforma del dispositivo

  • Android

  • iOS

  • Harmony

  • Web

sip

Dirección IP del cliente

198.51.100.1

durationMs

El tiempo transcurrido entre la inicialización del lado del cliente y la consulta, en milisegundos.

4968931

queryCount

El número de veces que se utilizó el token para consultas durante el día actual.

1

querySessionCount

El número de veces que se utilizó la sesión asociada al token para consultas durante el día actual.

2

queryUmidCount

El número de veces que se utilizó el dispositivo para consultas durante el día actual.

2