Caso os SDKs existentes não atendam aos seus requisitos de negócio, construa requisições HTTP personalizadas.
Se um SDK da Alibaba Cloud já oferecer suporte ao serviço e à linguagem desejados, utilize-o. Os SDKs gerenciam automaticamente a construção e a assinatura das requisições. Esta página destina-se a cenários em que não há um SDK adequado disponível.
Etapas
Etapa 1: Verifique o estilo da API do serviço em nuvem
O método de construção da requisição varia conforme o estilo da API do serviço alvo. Consulte a referência da API do seu serviço para confirmar se ele utiliza o estilo de chamada de procedimento remoto (RPC) ou arquitetura orientada a recursos (ROA). Para mais informações, consulte Estilos de API.
Etapa 2: Construa e assine a requisição
A sintaxe da requisição difere dependendo do estilo da API. Para instruções detalhadas, consulte Sintaxe de requisição e método de assinatura V3.
Etapa 3: Processe as respostas
Deserialize as respostas em objetos predefinidos caso conheça a estrutura esperada. Caso contrário, processe-as como dados genéricos.
Etapa 4: Adicione tratamento de exceções e lógica de nova tentativa
Interrupções de rede e parâmetros de requisição inválidos podem gerar exceções. Implemente mecanismos de tratamento de exceções e lógica de nova tentativa no seu cliente para lidar com essas situações.
Por que as requisições devem ser assinadas
A assinatura protege os serviços em nuvem contra requisições maliciosas e inválidas. Ela é calculada com base nos dados da requisição — incluindo credenciais, carimbo de data/hora e um número aleatório — e anexada a cada requisição antes do envio.
A assinatura atende a quatro objetivos de segurança:
Autenticação da requisição: O gateway da API valida se a requisição parte de um cliente legítimo, bloqueando acessos não autorizados antes que cheguem ao serviço.
Prevenção contra ataques de replay: Cada assinatura contém um carimbo de data/hora e um número aleatório, garantindo que uma requisição capturada não possa ser reutilizada.
Detecção de adulteração: Como a assinatura codifica o conteúdo da requisição, qualquer modificação durante a transmissão invalida a assinatura e resulta na rejeição da requisição.
Rastreabilidade: A assinatura inclui informações de origem e carimbo de data/hora, fornecendo aos provedores de serviço um rastro verificável para monitoramento e auditoria de acesso ao sistema.
Instruções
Leia o documento em inglês para compreender o que precisa ser comunicado
Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês
Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão
Tags xref (
<a data-tag="xref" ...>texto</a>) — preserve a TAG INTEIRA com todos os atributos na ordem e caixa originais, traduza APENAS o texto visível entre > eAplique todas as regras específicas do idioma rigorosamente
Aplique as regras de stopwords com tolerância zero
Use o modo imperativo em passos numerados e listas de procedimentos
Garanta consistência terminológica — mesmo termo = mesma tradução em todo o documento
Varie os inícios de frase em listas/tabelas — nenhum início repetido 3+ vezes
Retorne APENAS o documento markdown em português do Brasil, sem explicações