Este documento describe las API del lado del servidor para Alibaba Cloud ID Verification. Llame a estas API para integrar el servicio.
El endpoint público del servicio es cloudauth-intl.[region].aliyuncs.com. A continuación se muestra una tabla que indica el límite de consultas por segundo (QPS) para cada API en cada región.
|
Región |
ID de región |
QPS para una sola API |
|
Singapore |
ap-southeast-1 |
10 |
|
China (Hong Kong) |
cn-hongkong |
10 |
|
Malaysia (Kuala Lumpur) |
ap-southeast-3 |
3 |
|
Indonesia |
ap-southeast-5 |
3 |
Notas sobre los límites de QPS:
El límite de QPS especificado en este documento aplica a cada API dentro de una cuenta de Alibaba Cloud. Todos los usuarios de Resource Access Management (RAM) de la misma cuenta comparten este límite.
Si su tráfico supera el límite de QPS indicado, contacte a los equipos de producto y de negocio para solicitar un escalamiento.
El límite de QPS para las API del lado del servidor puede variar según la región. Los límites indicados en este documento son los oficiales.
Por requisitos de cumplimiento normativo, el servicio en Malasia e Indonesia utiliza un despliegue local. Antes de integrar el servicio, contacte al equipo de producto para confirmar el límite de QPS.
Verificación de identidad
Este servicio ofrece una solución integral en línea para la verificación de identidad. Combina funciones clave como la verificación de documentos, la detección de vida y la evaluación de riesgos.
El servicio admite los tres modos de integración siguientes:
Modo App SDK: el usuario inicia el proceso de verificación de identidad en la aplicación móvil del comerciante.
Modo Web SDK: el usuario inicia el proceso de verificación de identidad en un navegador móvil o de escritorio.
Modo de aplicación con WebView integrado: el usuario inicia el proceso de verificación de identidad en la aplicación móvil del comerciante mediante un WebView integrado.
App SDK, Web SDK y aplicación con WebView integrado
Nombre de la API | Descripción | Documentación | Portal de OpenAPI |
InitializeV2 | Llame a esta API antes de iniciar un flujo de autenticación eKYC PRO para obtener un En los modos Web SDK y aplicación con WebView integrado, la API también devuelve un ProductCode: | ||
CheckResult | Después de recibir una notificación de callback, llame a esta API para obtener el estado y los resultados de la autenticación. Estos incluyen el resultado de la verificación facial, el resultado de OCR del documento y el resultado de la evaluación de riesgos. Los resultados se conservan durante 30 días. |
Detección de vida
Este servicio ofrece una solución de autenticación en línea que verifica la identidad del usuario únicamente mediante la detección de vida facial, lo que elimina la necesidad de verificar documentos.
El servicio admite los cuatro modos de integración siguientes:
Modo App SDK: el usuario completa el proceso de detección de vida en la aplicación móvil del comerciante.
Modo Web SDK: el usuario completa el proceso de detección de vida en un navegador móvil o de escritorio.
Modo de aplicación con WebView integrado: el usuario completa el proceso de detección de vida en la aplicación móvil del comerciante mediante un WebView integrado.
Modo exclusivo del lado del servidor (API): el comerciante envía directamente imágenes faciales recopiladas previamente. El servidor ejecuta la detección de vida sin requerir la integración de un SDK de cliente.
App SDK, Web SDK y aplicación con WebView integrado
Nombre de la API | Descripción | Documentación | Portal de OpenAPI |
InitializeV2 | Llame a esta API antes de iniciar un flujo de autenticación de vida para obtener un En los modos Web SDK y aplicación con WebView integrado, la API también devuelve un ProductCode: | ||
CheckResult | Después de recibir una notificación de callback, llame a esta API para obtener el estado y los resultados de la autenticación, incluido el resultado de la autenticación de vida. Los resultados se conservan durante 30 días. |
Exclusivo del lado del servidor (API)
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
FaceLivenessV2 |
Envíe directamente una imagen facial para ejecutar la detección de vida y de deepfake mediante el modelo Qwen-VL, sin requerir un SDK ni desafíos interactivos de vida. Este modo es adecuado para escenarios con requisitos de seguridad relativamente bajos. Para escenarios de alta seguridad, se recomienda usar un modo SDK. ProductCode: |
Face Identity Unique
Proporciona varias soluciones de verificación de vida, incluidos los modos de verificación facial (1:1) y detección antiduplicados (búsqueda 1:N). Este servicio es adecuado para evitar registros duplicados y fraudes de identidad.
El servicio admite los cuatro modos de integración siguientes:
Modo App SDK: el usuario completa el proceso de verificación de vida, verificación facial o búsqueda antiduplicados en la aplicación móvil del comerciante.
Modo Web SDK: el usuario completa el proceso de verificación de vida, verificación facial o búsqueda antiduplicados en un navegador móvil o de escritorio.
Modo de aplicación con WebView integrado: el usuario completa el proceso de verificación de vida, verificación facial o búsqueda antiduplicados en la aplicación móvil del comerciante mediante un WebView integrado.
Modo exclusivo del lado del servidor (API): el comerciante envía directamente imágenes faciales recopiladas previamente. El servidor ejecuta la verificación de vida, la verificación facial o la búsqueda antiduplicados sin requerir la integración de un SDK de cliente.
App SDK, Web SDK y aplicación con WebView integrado
Nombre de la API | Descripción | Documentación | Portal de OpenAPI |
InitializeV2 | Llame a esta API antes de iniciar un flujo de autenticación para obtener un Para la integración con Web SDK, la API también devuelve un ProductCode: | ||
CheckResult | Después de recibir una notificación de callback, llame a esta API para obtener el estado y los resultados de la autenticación. La respuesta incluye el resultado de la autenticación de vida, la puntuación de comparación facial ( |
Exclusivo del lado del servidor (API)
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
FaceVerifyIntl |
Envíe directamente una imagen facial para detectar rostros duplicados y compararlos sin usar un SDK. Esta API admite los modos de verificación 1:1, búsqueda 1:N y combinado. ProductCode: |
Gestión de la base de datos facial
La gestión de la base de datos facial no es un producto independiente, sino una función de administración de la solución de detección 1:N en la verificación de vida. Se utiliza para gestionar los datos de la base de datos facial en las búsquedas 1:N.
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
AddFaceRecord |
Registra la imagen facial de un usuario en una base de datos facial específica. La API acepta entradas como cadena Base64, URL o flujo de archivo local, y devuelve el resultado del registro junto con una evaluación de calidad facial. |
||
|
DeleteFaceRecordV2 |
Elimina una imagen facial de una base de datos facial mediante el identificador único de usuario |
Comparación facial
Esta API exclusiva del lado del servidor compara la similitud entre dos imágenes faciales para determinar si pertenecen a la misma persona.
El servicio admite el siguiente modo de integración:
Modo exclusivo del lado del servidor (API): el comerciante envía directamente dos imágenes faciales. El servidor ejecuta la comparación y devuelve el resultado junto con una puntuación. No se requiere la integración de un SDK de cliente.
Exclusivo del lado del servidor (API)
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
FaceCompareV2 |
Envía dos imágenes faciales para determinar si pertenecen a la misma persona. La API devuelve un resultado de comparación ( |
OCR de documentos de identidad
Este servicio proporciona una solución de reconocimiento de documentos basada en el modelo Qwen-VL. Admite la detección automática y la extracción de información para diversos tipos de documentos de identidad en todo el mundo. Es ideal para la autenticación remota de identidad y la captura automática de datos.
El servicio admite los cuatro modos de integración siguientes:
Modo App SDK: el usuario completa el proceso de OCR de documentos de identidad en la aplicación móvil del comerciante.
Modo Web SDK: el usuario completa el proceso de OCR de documentos de identidad en un navegador móvil o de escritorio.
Modo de aplicación con WebView integrado: el usuario completa el proceso de OCR de documentos de identidad en la aplicación móvil del comerciante mediante un WebView integrado.
Modo exclusivo del lado del servidor (API): el comerciante envía directamente imágenes de documentos recopiladas previamente. El servidor ejecuta el OCR sin requerir la integración de un SDK de cliente.
App SDK, Web SDK y aplicación con WebView integrado
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
InitializeV2 |
Llame a esta API antes de iniciar un flujo de autenticación con OCR de documentos para obtener un ProductCode: |
||
|
CheckResult |
Después de recibir una notificación de callback, llame a esta API para obtener los resultados del servidor. El modelo Qwen-VL reconoce automáticamente el tipo de documento y extrae la información estructurada. Esta API admite el reconocimiento del anverso y reverso, así como la detección contra suplantación. |
Exclusivo del lado del servidor (API)
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
DocOcrMaxV2 |
Envía una imagen de documento. El modelo Qwen-VL reconoce automáticamente el tipo de documento y extrae la información estructurada. Esta API admite el reconocimiento del anverso y reverso, así como la detección contra suplantación. ProductCode: |
NFC de documentos de identidad
Esta solución de reconocimiento utiliza la comunicación de campo cercano (NFC) de un celular para decodificar los chips de los documentos. Lee la información cifrada del chip del documento para ayudar a prevenir ataques con imágenes sintéticas y mejorar la seguridad del negocio. Actualmente, esta función es compatible con pasaportes globales.
El servicio admite el siguiente modo de integración:
Modo App SDK: el usuario completa el proceso de NFC de documentos de identidad en la aplicación móvil del comerciante.
App SDK
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
InitializeV2 |
Llame a esta API después de que el cliente obtenga ProductCode: |
||
|
CheckResult |
Recupera el resultado de la lectura NFC, que incluye la información estructurada completa del pasaporte (como nombre, número de documento, nacionalidad y fecha de vencimiento) y una fotografía facial codificada en Base64. Los resultados se conservan durante 30 días. |
Device Guard
Device Guard es una solución de identificación de riesgos de dispositivos que se usa de forma independiente o como función auxiliar de control de riesgos. Recopila un token de dispositivo mediante un SDK de cliente y consulta el resultado de la evaluación de riesgos en el servidor para identificar amenazas como dispositivos con root o jailbreak, VPN, emuladores, entornos virtuales y comportamientos anómalos.
El servicio admite los dos modos de integración siguientes:
Modo App SDK: no involucra ningún proceso de negocio orientado al usuario.
Modo Web SDK: no involucra ningún proceso de negocio orientado al usuario.
App SDK y Web SDK
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
FaceGuardRisk |
Envía el ProductCode: |
Detección de manipulación de credenciales
Este servicio proporciona detección de riesgos para determinar si una imagen fue editada, capturada desde pantalla, recapturada o manipulada.
El servicio admite el siguiente modo de integración:
Modo exclusivo del lado del servidor (API): el comerciante envía directamente una imagen de credencial. El servidor ejecuta la evaluación de riesgos sin requerir la integración de un SDK de cliente.
Exclusivo del lado del servidor (API)
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
CredentialVerifyIntl |
Envía la información de la imagen de la credencial y devuelve una evaluación de riesgos como falsificación, manipulación, captura de pantalla y recaptura. ProductCode: |
Reconocimiento de credenciales
Impulsado por el modelo Qwen-VL, este servicio reconoce y extrae información clave de los documentos de credenciales que suben los usuarios. Genera datos estructurados y ofrece una función opcional de detección de falsificaciones.
El servicio admite el siguiente modo de integración:
Modo exclusivo del lado del servidor (API): el comerciante envía directamente una imagen de credencial o un archivo PDF. El servidor reconoce la información clave y evalúa el riesgo de falsificación sin requerir la integración de un SDK de cliente.
Exclusivo del lado del servidor (API): llamada síncrona
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
CredentialRecognitionIntlV2 |
Envía una imagen de credencial o un archivo PDF para reconocer la información clave y evaluar el riesgo de falsificación. ProductCode: |
Exclusivo del lado del servidor (API): llamada asíncrona
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
CredentialSubmitIntlV2 |
Envía una imagen de credencial o un archivo PDF para iniciar una tarea de reconocimiento y obtener un ProductCode: |
||
|
CredentialGetResultIntl |
Recupera de forma asíncrona la información clave y los resultados de la evaluación de riesgo de falsificación mediante un ProductCode: |
Servicio de verificación con fuentes oficiales de Indonesia
Es un servicio independiente de verificación de información de identidad para Indonesia. También funciona como complemento de la solución eKYC_PRO para escenarios de verificación con fuentes oficiales. Este servicio mejora la confiabilidad de la identidad del usuario al comparar el número de identificación nacional, el nombre, la imagen facial y la fecha de nacimiento proporcionados por el usuario con una base de datos oficial para comprobar su consistencia.
El servicio admite el siguiente modo de integración:
Modo exclusivo del lado del servidor (API): el comerciante envía directamente la información de identidad y una imagen facial para su verificación y comparación en el servidor. No se requiere la integración de un SDK de cliente.
Exclusivo del lado del servidor (API)
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
IdnAuthorityVerifyIntl |
Envía la información de identidad y una imagen facial al servidor para realizar la verificación con fuentes oficiales y devuelve el resultado de la comparación. ProductCode: |
Consulta de registros de autenticación
Esta API de utilidad para la resolución autónoma de problemas le permite consultar registros integrales con un TransactionId para analizar procesos de autenticación incompletos e identificar las razones por las que los usuarios abandonan el flujo. Esta API es gratuita. Solo puede consultar registros de soluciones que involucren integración del lado del cliente, no de soluciones exclusivas del lado del servidor (API).
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
CheckVerifyLog |
Envía el |
Eliminación de registros de autenticación
Esta API de utilidad elimina información sensible y datos de los resultados de autenticación de algunas soluciones de productos.
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
DeleteVerifyResult |
Envía el |
Mantenimiento de conexión del lado del cliente
Esta API de utilidad mantiene activa la conexión del cliente cuando el servidor llama a las API de ID Verification con poca frecuencia.
|
Nombre de la API |
Descripción |
Documentación |
Portal de OpenAPI |
|
KeepaliveIntl |
Esta API no tiene parámetros de entrada ni lógica de negocio específica. Cuando el servidor llama a las API de ID Verification con poca frecuencia, el cliente puede llamar proactivamente a esta API para mantener la conexión activa. |