SingleSendMail - - Centro de documentación de Alibaba Cloud

Este tema describe cómo llamar a la operación SingleSendMail para enviar un correo electrónico individual. La operación SingleSendMail no admite el envío de archivos adjuntos.

Depuración

Puede llamar a esta operación directamente en OpenAPI Explorer. Esto le ahorra el esfuerzo de calcular firmas. Después de una llamada exitosa, OpenAPI Explorer genera automáticamente ejemplos de código del SDK.

Parámetros de solicitud

Nombre	Tipo	Obligatorio	Ejemplo	Descripción
AccountName	String	Sí	test***@example.net	La dirección del remitente configurada en la consola de Direct Mail.
AddressType	Integer	Sí	1	El tipo de dirección del remitente. Valores válidos: 0: cuenta aleatoria 1: dirección del remitente
ReplyToAddress	String	Sí	true	Indica si se usa la dirección de respuesta configurada en la consola. El estado de la dirección de respuesta debe estar verificado. Los valores válidos son las cadenas "true" y "false", no valores booleanos.
Subject	String	Sí	Asunto	El asunto del correo electrónico. No puede exceder los 100 caracteres.
ToAddress	String	Sí	test1***@example.net	La dirección del destinatario. Puede especificar varias direcciones de destinatario separadas por comas (,). Se admiten hasta 100 direcciones y grupos de cuentas.
Action	String	No	SingleSendMail	Parámetro obligatorio. Establezca el valor en SingleSendMail.
ClickTrace	String	No	0	1: habilita el seguimiento de datos. 0 (predeterminado): deshabilita el seguimiento de datos.
FromAlias	String	No	Xiao Hong	El alias del remitente. Puede tener hasta 15 caracteres. Por ejemplo, si establece el alias del remitente como "Alice" y la dirección como test@example.net, el destinatario verá "Alice" <test@example.net>.
HtmlBody	String	No	body	El cuerpo HTML del correo electrónico. El tamaño está limitado a 80 KB por el SDK. Nota: HtmlBody y TextBody definen el contenido del correo. Debe especificar uno de ellos.
TagName	String	No	test	La etiqueta creada en la consola de Direct Mail. Permite clasificar lotes de correos electrónicos y consultar el estado de envío de cada lote. Si habilita el seguimiento de correos, debe usar una etiqueta.
TextBody	String	No	body	El cuerpo de texto del correo electrónico. El tamaño está limitado a 80 KB por el SDK. Nota: HtmlBody y TextBody definen el contenido del correo. Debe especificar uno de ellos.
ReplyAddress	String	No	test2***@example.net	La dirección de respuesta.
ReplyAddressAlias	String	No	Xiaohong	El alias de la dirección de respuesta.
UnSubscribeLinkType	String	No	default	El tipo de enlace de cancelación de suscripción por generar. Para obtener más información, consulte Unsubscribe feature. Disabled: La generación está deshabilitada. default: Se genera un enlace de cancelación de suscripción para correos enviados desde direcciones de remitente por lotes a dominios específicos, como los que contienen las palabras clave "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook", "ymail.com", etc. zh-cn: Generado para instrumentación futura de contenido. en-us: Generado para instrumentación futura de contenido.
UnSubscribeFilterLevel	String	No	mailfrom_domain	El nivel de filtrado. Para obtener más información, consulte Unsubscribe feature. disabled: No filtra. default: Usa la política predeterminada. Los correos por lotes se filtran por dirección del remitente. mailfrom: Filtra por dirección del remitente. mailfrom_domain: Filtra por nombre de dominio del remitente. edm_id: Filtra por cuenta.

Parámetros de respuesta

Nombre	Tipo	Ejemplo	Descripción
EnvId	String	xxxxxx	El ID del evento.
RequestId	String	2D086F6-8F31-4658-84C1-006DED011A85	El ID de la solicitud.

Ejemplos

Ejemplo de solicitud

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

Ejemplos de respuesta

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidReceiverName.Malformed	The specified receiver name is wrongly formed.	La dirección del destinatario tiene un formato no válido. Debe contener un signo de arroba (@). El nombre de la cuenta y el nombre de dominio solo pueden contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
404	InvalidMailAddress.NotFound	The specified mail address is not found.	No se encontró la dirección del remitente.
404	InvalidReceiver.NotFound	The specified receiver is invalid.	El destinatario no existe. Compruebe si la dirección del destinatario es válida.
400	InvalidToAddress	The specified toAddress is wrongly formed.	La dirección del destinatario tiene un formato no válido. Debe contener un signo de arroba (@). El nombre de la cuenta y el nombre de dominio solo pueden contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
400	InvalidToAddress.Spam	Sendmail rejected by invalid address.	La dirección no es válida. Compruebe la validez de la dirección.
400	InvalidBody	The specified textBody or htmlBody is wrongly formed.	El formato de TextBody o HtmlBody no es válido. Especifique el contenido nuevamente.
400	InvalidSendMail.Spam	Sendmail rejected by spam filter.	Error en el envío del correo electrónico. Compruebe el estado del usuario para detectar problemas como un límite de frecuencia excedido o una cuota insuficiente.
400	InvalidMailAddressSendType.Malformed	The specified mailAddress sendType is wrongly formed.	El tipo de envío no es válido. Vaya a la consola para comprobar el tipo y establezca el valor correspondiente.
400	InvalidMailAddressStatus.Malformed	The specified mailAddress status is wrongly formed.	El estado de la dirección del remitente no es válido. Compruebe si la dirección está activa o congelada.
400	InvalidMailAddressDomain.Malformed	The specified mailAddress domain does not exist.	El nombre de dominio tiene un formato no válido. Solo puede contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
400	InvalidSubject.Malformed	The specified subject is invalid. It must not exceed 100 characters.	El asunto no es válido. No puede exceder los 100 caracteres.
400	InvalidFromAlias.Malformed	The specified fromAlias is wrongly formed.	El alias del remitente tiene un formato no válido. No puede exceder los 15 caracteres.
400	InvalidReplyAddressAlias.Malformed	The specified replyAddressAlias is wrongly formed.	El alias de la dirección de respuesta tiene un formato no válido. No puede exceder los 15 caracteres.
400	InvalidReplyAddress.Malformed	The specified replyAddress is wrongly formed.	La dirección de respuesta tiene un formato no válido. Debe contener un signo de arroba (@). El nombre de la cuenta y el nombre de dominio solo pueden contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
404	InvalidIP.NotFound	The specified IP address is invalid.	La dirección IP especificada no es válida. Si ha habilitado la protección de IP, asegúrese de que la dirección IP esté en la lista.
400	InvalidFromALias.Malformed	The specified fromAlias is wrongly formed.	El alias del remitente no es válido. Compruebe el alias del remitente. Debe tener menos de 15 caracteres.

Para obtener más información sobre los códigos de error, consulte Error Center.