Como chamar SingleSendMail para enviar um único e-mail - : Central de Documentação do Alibaba Cloud

Este tópico descreve como chamar a operação SingleSendMail para enviar um único e-mail. A operação SingleSendMail não oferece suporte ao envio de anexos.

Depuração

Chame esta operação diretamente no OpenAPI Explorer. Isso elimina a necessidade de calcular assinaturas. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente exemplos de código do software development kit (SDK).

Parâmetros da solicitação

Nome	Tipo	Obrigatório	Exemplo	Descrição
AccountName	String	Sim	test***@example.net	Endereço do remetente configurado no console do Direct Mail.
AddressType	Integer	Sim	1	Tipo de endereço do remetente. Valores válidos: 0: conta aleatória 1: endereço do remetente
ReplyToAddress	String	Sim	true	Indica se o endereço de resposta configurado no console deve ser usado. O status do endereço de resposta precisa estar verificado. Os valores válidos são as strings "true" e "false", e não valores booleanos.
Subject	String	Sim	Subject	Assunto do e-mail. Não pode exceder 100 caracteres.
ToAddress	String	Sim	test1***@example.net	Endereço do destinatário. Especifique vários endereços separados por vírgulas (,). Limite de até 100 endereços. Há suporte para grupos de contas.
Action	String	Não	SingleSendMail	Parâmetro obrigatório. Defina o valor como SingleSendMail.
ClickTrace	String	Não	0	1: ativa o rastreamento de dados. 0 (padrão): desativa o rastreamento de dados.
FromAlias	String	Não	Xiao Hong	Alias do remetente. Pode ter até 15 caracteres. Por exemplo, se você definir o alias do remetente como "Alice" e o endereço como test@example.net, o destinatário verá "Alice" <test@example.net>.
HtmlBody	String	Não	body	Corpo HTML do e-mail. Tamanho limitado a 80 KB pelo software development kit (SDK). Observação: HtmlBody e TextBody definem o conteúdo do e-mail. Especifique um deles.
TagName	String	Não	test	Tag criada no console do Direct Mail. Use tags para classificar lotes de e-mails e consultar o status de envio de cada lote. Se o rastreamento de e-mail estiver ativado, o uso de tag é obrigatório.
TextBody	String	Não	body	Corpo de texto do e-mail. Tamanho limitado a 80 KB pelo SDK. Observação: HtmlBody e TextBody definem o conteúdo do e-mail. Especifique um deles.
ReplyAddress	String	Não	test2***@example.net	Endereço de resposta.
ReplyAddressAlias	String	Não	Xiaohong	Alias do endereço de resposta.
UnSubscribeLinkType	String	Não	default	Tipo de link de cancelamento de inscrição a gerar. Para obter mais informações, consulte Recurso de cancelamento de inscrição. Disabled: geração desativada. default: gera um link de cancelamento de inscrição para e-mails de endereços de remetente em lote enviados a nomes de domínio específicos, como os que contêm as palavras-chave "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook", "ymail.com", entre outros. zh-cn: gerado para instrumentação futura de conteúdo. en-us: gerado para instrumentação futura de conteúdo.
UnSubscribeFilterLevel	String	Não	mailfrom_domain	Nível de filtragem. Para obter mais informações, consulte Recurso de cancelamento de inscrição. disabled: não filtra. default: usa a política padrão. E-mails em lote são filtrados no nível do endereço do remetente. mailfrom: filtra no nível do endereço do remetente. mailfrom_domain: filtra no nível do nome de domínio do remetente. edm_id: filtra no nível da conta.

Parâmetros de resposta

Nome	Tipo	Exemplo	Descrição
EnvId	String	xxxxxx	ID do evento.
RequestId	String	2D086F6-8F31-4658-84C1-006DED011A85	ID da solicitação.

Exemplos

Exemplo de solicitação

https://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test***@example.net&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1***@example.net&<Common request parameters>

Exemplos de resposta

Formato XML

<SingleSendMailResponse>      <EnvId>xxxxxx</EnvId>      <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>

Formato JSON

{    "EnvId":"xxxxxx",    "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidReceiverName.Malformed	The specified receiver name is wrongly formed.	Formato inválido do endereço do destinatário. O endereço deve conter o símbolo de arroba (@). O nome da conta e o nome de domínio podem conter apenas letras, dígitos, sublinhados (_), hifens (-) e pontos (.).
404	InvalidMailAddress.NotFound	The specified mail address is not found.	Endereço do remetente não encontrado.
404	InvalidReceiver.NotFound	The specified receiver is invalid.	Destinatário inexistente. Verifique se o endereço do destinatário é válido.
400	InvalidToAddress	The specified toAddress is wrongly formed.	Formato inválido do endereço do destinatário. O endereço deve conter o símbolo de arroba (@). O nome da conta e o nome de domínio podem conter apenas letras, dígitos, sublinhados (_), hifens (-) e pontos (.).
400	InvalidToAddress.Spam	Sendmail rejected by invalid address.	Endereço inválido. Verifique a validade do endereço.
400	InvalidBody	The specified textBody or htmlBody is wrongly formed.	Formato inválido de TextBody ou HtmlBody. Especifique o conteúdo novamente.
400	InvalidSendMail.Spam	Sendmail rejected by spam filter.	Falha no envio do e-mail. Verifique o status do usuário quanto a problemas como limite de frequência excedido ou cota insuficiente.
400	InvalidMailAddressSendType.Malformed	The specified mailAddress sendType is wrongly formed.	Tipo de envio inválido. Acesse o console para verificar o tipo e defina o valor adequadamente.
400	InvalidMailAddressStatus.Malformed	The specified mailAddress status is wrongly formed.	Status inválido do endereço do remetente. Verifique se o endereço está ativo ou congelado.
400	InvalidMailAddressDomain.Malformed	The specified mailAddress domain does not exist.	Formato inválido do nome de domínio. Ele pode conter apenas letras, dígitos, sublinhados (_), hifens (-) e pontos (.).
400	InvalidSubject.Malformed	The specified subject is invalid. It must not exceed 100 characters.	Assunto inválido. Não pode exceder 100 caracteres.
400	InvalidFromAlias.Malformed	The specified fromAlias is wrongly formed.	Formato inválido do alias do remetente. Não pode exceder 15 caracteres.
400	InvalidReplyAddressAlias.Malformed	The specified replyAddressAlias is wrongly formed.	Formato inválido do alias do endereço de resposta. Não pode exceder 15 caracteres.
400	InvalidReplyAddress.Malformed	The specified replyAddress is wrongly formed.	Formato inválido do endereço de resposta. O endereço deve conter o símbolo de arroba (@). O nome da conta e o nome de domínio podem conter apenas letras, dígitos, sublinhados (_), hifens (-) e pontos (.).
404	InvalidIP.NotFound	The specified IP address is invalid.	Endereço IP especificado inválido. Se a proteção de IP estiver ativada, certifique-se de que o endereço IP esteja na lista.
400	InvalidFromALias.Malformed	The specified fromAlias is wrongly formed.	Alias do remetente inválido. Verifique o alias do remetente. Deve ter menos de 15 caracteres.

Para obter mais informações sobre códigos de erro, consulte Error Center.