Use o OpenAPI Explorer para chamar operações de API do Direct Mail, depurá-las e gerar códigos de exemplo do SDK.
O OpenAPI Explorer permite localizar, depurar e gerar códigos de exemplo para as operações de API do Direct Mail.
Processo básico:
1. Acesse a página do OpenAPI Explorer
Exemplo: enviar um e-mail.
Enviar um e-mail (depuração e visualização de código de exemplo)
Envie um único e-mail:
Depure e visualize o código de exemplo:
https://api.alibabacloud.com/api/Dm/2015-11-23/SingleSendMail
O sistema suporta chamadas em loop e concorrentes.
Uma única solicitação aceita até 100 endereços de destinatário. Para outros parâmetros, consulte SingleSendMail.
Envie e-mails em lote:
Depure e visualize o código de exemplo:
https://api.alibabacloud.com/api/Dm/2015-11-23/BatchSendMail
Use um modelo e uma lista de destinatários criados no console ou via API para enviar e-mails em lote. Para outros parâmetros, consulte BatchSendMail.
2. Consulte as operações de API e especifique os parâmetros
Use a versão padrão da API 2015-11-23. O identificador de versão permanece inalterado, embora as operações de API recebam atualizações contínuas.
Visualize a documentação da operação de API:
3. Selecione uma linguagem de programação para depuração
Selecione uma linguagem de programação e clique em "Initiate Call".
4. Gere o código de exemplo
Método 1: Use o SDK do Direct Mail
Obtenha o comando de instalação do SDK
Após um teste bem-sucedido, instale o SDK na máquina local ou no servidor.
A seção "SDK Info" exibe a versão do SDK e o comando de instalação.
Método 2: Use CommonRequest
Mude para "Generate code in Common mode". Por padrão, os parâmetros são passados no corpo da solicitação para evitar limites de tamanho da URL.
Exemplo em C#:
Referências:
Chamadas generalizadas Java 1.0 (Será descontinuado)
Chamadas generalizadas Java 2.0
FAQ
Como crie um AccessKey?
Ao fazer login na conta Alibaba Cloud, a página de depuração não exige chave. No entanto, configure a chave no código para implantação local ou em servidor.
Também é possível usar um par de AccessKey criado no RAM.
Faça login no console de gerenciamento de AccessKey.
No canto superior direito, clique em Create AccessKey.
Leia o aviso e clique em OK.
Não codifique rigidamente os valores "AccessKeyID" e "accesskeysecret" no código para evitar vazamentos.
Os SDKs da Alibaba Cloud suportam as variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET para autenticação, conforme descrito em Configuração de verificação de identidade.
Erro SignatureDoesNotMatch
SignatureDoesNotMatch
Message: Specified signature is not matched with our calculation.
Caso use um mecanismo de assinatura própria, verifique se a ordem dos parâmetros e a codificação estão corretas. Use o SDK do Direct Mail para simplificar o processo de assinatura.
Verifique se o segredo do AccessKey está incorreto.
Mensagem de erro para AccessKey ID incorreto: Specified access key is not found.
Mensagem de erro para segredo de AccessKey incorreto: Specified signature is not matched with our calculation.
Verifique a diferença de horário do sistema.
Certifique-se de que o horário do sistema não difere do horário do servidor em mais de 15 minutos.
Se o sistema estiver em um fuso horário diferente, sincronize-o com UTC+8.
Comandos para consultar o horário do sistema
Windows:
echo %date% %time%
tzutil /gMac:
date
systemsetup -gettimezone