Os SDKs do Alibaba Cloud são pacotes pré-construídos para chamar operações da API do Alibaba Cloud. Eles gerenciam autenticação, assinatura de requisições e integração específica por linguagem. Assim, você foca no desenvolvimento da aplicação em vez de implementar a mecânica da API do zero.
O que são os SDKs do Alibaba Cloud?
Os SDKs do Alibaba Cloud são pacotes para chamar operações de API dos serviços do Alibaba Cloud. Estão disponíveis para diversas linguagens de programação e frameworks de desenvolvimento, incluindo Java, Python, Node.js e Go.
Usar um SDK em vez de chamar a API REST diretamente oferece várias vantagens práticas:
Lógica de assinatura dispensada: O SDK cuida automaticamente da verificação de identidade, autenticação e assinatura das requisições.
Desenvolvimento mais ágil: Componentes pré-construídos permitem chamar operações de API com poucas linhas de código, sem montar requisições HTTP brutas.
Comportamento consistente entre linguagens: O funcionamento do SDK é padronizado em todas as linguagens suportadas, o que reduz imprevistos durante a integração.
Para obter informações básicas sobre operações de API, consulte a seção "What is Alibaba Cloud API?" no tópico Visão geral.
Quais tipos de SDK o Alibaba Cloud fornece?
Os SDKs do Alibaba Cloud dividem-se em dois tipos:
SDKs gerados automaticamente pelo OpenAPI Portal — SDKs padronizados criados a partir das operações de API registradas do serviço. Disponíveis para múltiplas linguagens de programação. Exemplos: SDKs para Elastic Compute Service (ECS), ApsaraDB RDS e serviços de rede.
SDKs desenvolvidos internamente — SDKs mantidos por serviços de nuvem individuais que utilizam gateways de API autogerenciados. Estes variam conforme o serviço. Exemplos: SDKs para Object Storage Service (OSS), Simple Log Service e Tablestore.
Devido à natureza de certos serviços de nuvem, este tópico não aborda SDKs desenvolvidos internamente e usados para integração de recursos específicos, como o Queen SDK para ApsaraVideo Live, o SDK para login com um clique do Phone Number Verification Service ou o cliente terminal para ApsaraDB for Redis.
Qual tipo devo usar?
|
Meu cenário |
Tipo de SDK recomendado |
|
O serviço desejado aparece no OpenAPI Portal com um botão Debugging na referência de API |
SDK gerado automaticamente |
|
A documentação do serviço inclui uma seção intitulada "Use OpenAPI" ou "Integration overview" |
SDK gerado automaticamente |
SDKs gerados automaticamente pelo OpenAPI Portal
Esses SDKs são gerados diretamente das operações de API registradas no OpenAPI Portal. Eles padronizam as regras de verificação de identidade, autenticação e assinatura em todas as linguagens suportadas. Não implemente a lógica do SDK com base no serviço de nuvem subjacente, pois o portal faz isso por você.
Como identificar SDKs deste tipo
Abra a Referência de API do serviço do Alibaba Cloud desejado. Se houver um botão Debugging com link para o OpenAPI Portal, as operações de API do serviço estarão registradas lá e será possível gerar um SDK automaticamente.
Verifique na documentação do serviço se existem seções chamadas Use OpenAPI ou Integration overview.
Observação sobre SDKs desenvolvidos internamente
Alguns serviços do Alibaba Cloud utilizam gateways autogerenciados e mantêm seus próprios SDKs desenvolvidos internamente. Esses SDKs diferem consideravelmente daqueles gerados automaticamente. Use-os conforme suas necessidades de negócio e consulte a documentação do serviço correspondente para mais detalhes.
O rest desta documentação aborda as tecnologias e padrões de integração para SDKs gerados automaticamente no OpenAPI Portal.