Todos los productos
Search
Centro de documentos

ID Verification:Use OpenAPI

Última actualización: Sep 18, 2026

Depure las API del lado del servidor de ID Verification en el portal de Alibaba Cloud OpenAPI y obtenga código de ejemplo del SDK para la integración.

Requisitos previos

Debe contar con el servicio activated ID Verification.

Endpoints de la API del lado del servidor

Nota

Los endpoints varían según el servicio de API. Consulte la documentación de la API para identificar el endpoint correcto.

China (Hong Kong)

  • Endpoint público: cloudauth-intl.cn-hongkong.aliyuncs.com

  • Endpoint interno: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

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

  • Endpoint público: cloudauth-intl.ap-southeast-5.aliyuncs.com

  • Endpoint interno: cloudauth-intl-vpc.ap-southeast-5.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

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

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

Métodos de integración

Alibaba Cloud proporciona SDK para los lenguajes de programación más populares que encapsulan las API de ID Verification. Utilice un SDK para invocar las API sin gestionar detalles de bajo nivel.

Si los SDK no cubren sus necesidades, puede construir manualmente solicitudes HTTPS firmadas. El proceso de firma es complejo, por lo que se recomienda evaluar si este enfoque está justificado.

Método de integración

Descripción

SDK de Alibaba Cloud

Para conocer los lenguajes de programación compatibles, las versiones del SDK y las instrucciones de instalación, consulte el centro de SDK de ID Verification.

Depuración en línea y código de ejemplo

En la documentación de la API, utilice la sección Debugging para acceder a la página Response o SDK Sample Code.image

Paso

Descripción

1

Vaya al portal de OpenAPI de ID Verification e inicie sesión en su cuenta de Alibaba Cloud.

2

Seleccione o busque la API de destino. Si navegó desde la documentación de la API, la página correspondiente se abre automáticamente.

3

Seleccione un endpoint. El código de ejemplo del panel derecho se actualiza en consecuencia.

Nota

Los endpoints varían según el servicio de API. Consulte la documentación de la API para identificar el endpoint correcto.

4

Introduzca los parámetros de depuración. Los parámetros completados aparecen en el código de ejemplo del panel derecho. Para invocar la API en línea, haga clic en Initiate Call en la esquina inferior derecha. El resultado se muestra en la página Call Result.

Nota

Las llamadas a API de pago pueden generar cargos.

5

En la parte superior del panel derecho, haga clic en SDK Sample Code.

6

Seleccione una versión del SDK y un lenguaje de programación.

Nota

Se recomienda usar el SDK V2.0 para mejorar la seguridad y la eficiencia.

7

El código de ejemplo se actualiza en tiempo real conforme modifica la configuración. En la esquina superior izquierda del área de código:

  • Haga clic en Example para ejecutar el código de ejemplo en línea.

  • Haga clic en Download Project para descargar el proyecto de forma local.

En la esquina superior derecha del área de código:

  • Haga clic en SDK installation information para consultar las instrucciones de instalación de dependencias.

Aviso

Reutilice la instancia Client proporcionada por el SDK de Alibaba Cloud en varias solicitudes. No cree una nueva instancia Client para cada solicitud, ya que esto puede causar problemas de rendimiento.

Credenciales de acceso

Las llamadas a la API de ID Verification requieren credenciales de acceso válidas para la autenticación. Los tipos de credenciales más comunes son:

  • AccessKey: Un AccessKey (AK) es una credencial permanente compuesta por un AccessKey ID y un AccessKey Secret. Se emite para cuentas de Alibaba Cloud y usuarios de RAM. Para obtener más información, consulte Create an AccessKey.

  • Token de STS: Un token de Security Token Service (STS) es una credencial temporal emitida para roles de RAM, con un periodo de validez y permisos configurables. Para obtener más información, consulte STS overview.

Nota

Si utiliza un usuario o rol de RAM para invocar las API de ID Verification, después de crearlo, solicite a su administrador del sistema que otorgue la política AliyunAntCloudAuthFullAccess.

La filtración de credenciales representa un riesgo de seguridad. Utilice las siguientes soluciones para proteger sus credenciales de acceso:

Tipo de credencial

Solución

Escenario aplicable

AccessKey

Configure environment variables in Linux, macOS, and Windows systems

Almacene las credenciales en variables de entorno del sistema para configurar el acceso a las OpenAPI de Alibaba Cloud.

Token de STS

Container instance role assumption

Para aplicaciones en clústeres de ACK (Container Service for Kubernetes) de Alibaba Cloud, utilice RRSA (RAM Roles for Service Accounts) para asignar roles de RAM independientes por aplicación.

Siga las indicaciones de Best practices for using access credentials to access Alibaba Cloud OpenAPI.

Errores y soluciones

Resuelva los problemas de integración más comunes:

Lenguaje del SDK

Cómo capturar excepciones

Problemas comunes y soluciones

Java

Java exception handling

Java FAQ

Python

Python exception handling

Python FAQ

PHP

PHP exception handling

PHP FAQ

TypeScript

TypeScript exception handling

TypeScript FAQ

.NET

.NET exception handling

.NET FAQ

Go

Go exception handling

Go FAQ

Preguntas frecuentes sobre la integración del SDK

Referencia de código de ejemplo

Siga los pasos de la sección Online debugging and sample code para obtener código de ejemplo desde el portal de OpenAPI. Además, se proporciona un número limitado de ejemplos de código listos para ejecutarse como referencia. Consulte IDV server-side sample code.

Solución ante alta latencia en las llamadas a la API

Si experimenta alta latencia al invocar las API del lado del servidor, consulte Optimize server-side network latency para obtener guías de solución de problemas y optimización.

Construcción manual de solicitudes HTTPS

Para construir manualmente solicitudes HTTPS, consulte Request structure and signature mechanism.