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
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.comEndpoint interno:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
Asia Pacific SE 1 (Singapore)
Endpoint público:
cloudauth-intl.ap-southeast-1.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
Indonesia
Endpoint público:
cloudauth-intl.ap-southeast-5.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.ap-southeast-5.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
US West 1 (Silicon Valley)
Endpoint público:
cloudauth-intl.us-west-1.aliyuncs.comEndpoint interno:
cloudauth-intl-vpc.us-west-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
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.
|
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:
En la esquina superior derecha del área de código:
|
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.
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 |
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 |
||
|
Python |
||
|
PHP |
||
|
TypeScript |
||
|
.NET |
||
|
Go |
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.