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:
NotaUna 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.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
Asia Pacific SE 5 (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
US West 1 (Silicon Valley)
Endpoint público:
cloudauth-intl.us-west-1.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.us-west-1.aliyuncs.com
Europe Central 1 (Frankfurt)
Endpoint público:
cloudauth-intl.eu-central-1.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.eu-central-1.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 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 | ROOT,VPN,HOOK |
Result.RiskExtends | String | Para obtener más información, consulte Result.RiskExtends. | |
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 |
|
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 |
|
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 |