Todos los productos
Search
Centro de documentos

ID Verification:Server-side API reference

Última actualización: Oct 20, 2026

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

Nota

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 TransactionId que vincule todo el proceso.

En los modos Web SDK y aplicación con WebView integrado, la API también devuelve un TransactionUrl para redirigir páginas o integrar iframes, así como un Protocol para personalizar el idioma y los estilos de la interfaz.

ProductCode: eKYC_PRO

InitializeV2

InitializeV2

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.

CheckResult

CheckResult

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 TransactionId que vincule todo el proceso.

En los modos Web SDK y aplicación con WebView integrado, la API también devuelve un TransactionUrl para redirigir páginas o integrar iframes, así como un Protocol para personalizar el idioma y los estilos de la interfaz.

ProductCode: FACE_LIVENESS_PRO

InitializeV2

InitializeV2

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.

CheckResult

CheckResult

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

FACE_LIVENESS_MIN_PRO

FaceLivenessV2

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 TransactionId que vincule todo el proceso. Configure el modo de verificación (VerifyModel: 0 para el modo de búsqueda, 1 para el modo de verificación o 2 para el modo integral).

Para la integración con Web SDK, la API también devuelve un TransactionUrl para redirigir páginas o integrar iframes, así como un Protocol para personalizar el idioma y los estilos de la interfaz.

ProductCode: FACE_IDU

InitializeV2

InitializeV2

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 (faceComparisonScore), el resultado de detección de rostros duplicados (duplicateFace) y el ID de registro en la base de datos facial (faceRegistrationID). Los resultados de la autenticación se conservan durante 30 días.

CheckResult

CheckResult

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

FACE_IDU_MIN

FaceVerifyIntl

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.

Add a face image to a face database

AddFaceRecord

DeleteFaceRecordV2

Elimina una imagen facial de una base de datos facial mediante el identificador único de usuario MerchantUserId. Este identificador debe coincidir con el utilizado durante el registro con la API AddFaceRecord. La API devuelve el estado de la eliminación.

Delete a face image from the face database

DeleteFaceRecordV2

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 (Passed) y una puntuación de similitud (de 0 a 100). Los métodos de entrada compatibles incluyen Base64, URL y flujo de archivo local.

FACE_COMPARE

FaceCompareV2

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 TransactionId que vincule todo el proceso.

ProductCode: ID_OCR_PRO

InitializeV2

InitializeV2

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.

CheckResult

CheckResult

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

ID_OCR_MAX

DocOcrMaxV2

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 MetaInfo para recuperar un TransactionId y un Protocol. Actualmente, esta función solo admite pasaportes globales (DocType=01000000) y permite configurar el origen de los parámetros del documento de viaje legible por máquina (MRTD): entrada del usuario, OCR o envío mediante API.

ProductCode: ID_NFC

InitializeV2

InitializeV2

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.

CheckResult

CheckResult

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 DeviceToken generado por el SDK de cliente para recuperar la puntuación de riesgo del dispositivo (GuardRiskScore, de 0 a 100) y las etiquetas de riesgo (RiskTags, como ROOT, VPN y emulador).

ProductCode: FACE_GUARD_PRO

Server-Side API

FaceGuardRisk

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

CREDENTIAL_DETECT

CredentialVerifyIntl

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

Synchronous call

CredentialRecognitionIntlV2

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

ProductCode: CREDENTIAL_RECOGNITION

Submit a task

CredentialSubmitIntlV2

CredentialGetResultIntl

Recupera de forma asíncrona la información clave y los resultados de la evaluación de riesgo de falsificación mediante un TransactionId.

ProductCode: CREDENTIAL_RECOGNITION

Query the result

CredentialGetResultIntl

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

IDN_META

IdnAuthorityVerifyIntl

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 TransactionId obtenido de la llamada a la API InitializeV2 para recuperar los registros integrales.

Query end-to-end authentication logs

CheckVerifyLog

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 TransactionId obtenido de la llamada a la API InitializeV2, junto con el alcance de los datos que se eliminarán y las configuraciones relacionadas, para borrar el registro de autenticación correspondiente.

Delete authentication records

DeleteVerifyResult

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.

Client-side connection keep-alive

KeepaliveIntl