Si los SDK existentes no cubren sus necesidades de negocio, construya solicitudes HTTP personalizadas.
Si un SDK de Alibaba Cloud ya es compatible con el servicio y el lenguaje que necesita, utilice ese SDK. Los SDK se encargan automáticamente de construir y firmar las solicitudes. Esta página está pensada para los casos en los que no hay un SDK adecuado disponible.
Pasos
Paso 1: Compruebe el estilo de API del servicio en la nube
El método para construir la solicitud depende del estilo de API del servicio de destino. Revise la referencia de API de su servicio para confirmar si utiliza el estilo de llamada a procedimiento remoto (RPC) o de arquitectura orientada a recursos (ROA). Para obtener más información, consulte API styles.
Paso 2: Construya y firme la solicitud
La sintaxis de la solicitud varía según el estilo de API. Para ver las instrucciones detalladas, consulte Request syntax and signature method V3.
Paso 3: Procese las respuestas
Si conoce la estructura esperada de la respuesta, deserialícela en objetos predefinidos. De lo contrario, procésela como datos genéricos.
Paso 4: Agregue el manejo de excepciones y la lógica de reintentos
Las interrupciones de red y los parámetros de solicitud no válidos pueden generar excepciones. Integre el manejo de excepciones y la lógica de reintentos en su cliente para gestionar estos casos.
Por qué se deben firmar las solicitudes
La firma protege los servicios en la nube contra solicitudes maliciosas y no válidas. Se calcula a partir de los datos de la solicitud —que incluyen credenciales, una marca de tiempo y un número aleatorio— y se adjunta a cada solicitud antes de enviarla.
La firma cumple cuatro objetivos de seguridad:
Autenticación de la solicitud: la puerta de enlace de API verifica que la solicitud provenga de un cliente legítimo. Esto bloquea las solicitudes no autorizadas antes de que lleguen al servicio.
Prevención de ataques de repetición: cada firma incluye una marca de tiempo y un número aleatorio. Esto garantiza que una solicitud capturada no se pueda reutilizar.
Detección de alteraciones: la firma codifica el contenido de la solicitud. Por lo tanto, cualquier modificación durante la transmisión invalida la firma y provoca el rechazo de la solicitud.
Capacidad de auditoría: la firma contiene información de origen y una marca de tiempo. Esto proporciona a los proveedores del servicio un registro verificable para rastrear y auditar el acceso al sistema.