Cette rubrique explique comment appeler l'opération SingleSendMail pour envoyer un seul e-mail. L'opération SingleSendMail ne prend pas en charge l'envoi de pièces jointes.
Débogage
Paramètres de requête
Nom | Type | Obligatoire | Exemple | Description |
AccountName | String | Oui | test***@example.net | L'adresse de l'expéditeur que vous configurez dans la console Direct Mail. |
AddressType | Integer | Oui | 1 | Le type d'adresse de l'expéditeur. Valeurs possibles :
|
ReplyToAddress | String | Oui | true | Indique s'il faut utiliser l'adresse de réponse configurée dans la console. L'état de l'adresse de réponse doit être vérifié. Les valeurs valides sont les chaînes « true » et « false », et non des valeurs booléennes. |
Subject | String | Oui | Subject | L'objet de l'e-mail. L'objet ne peut pas dépasser 100 caractères. |
ToAddress | String | Oui | test1***@example.net | L'adresse du destinataire. Vous pouvez spécifier plusieurs adresses de destinataires en les séparant par des virgules (,). Vous pouvez spécifier jusqu'à 100 adresses de destinataires. Les groupes de comptes sont pris en charge. |
Action | String | Non | SingleSendMail | Le paramètre obligatoire. Définissez la valeur sur SingleSendMail. |
ClickTrace | String | Non | 0 |
|
FromAlias | String | Non | Xiao Hong | L'alias de l'expéditeur. L'alias peut comporter jusqu'à 15 caractères. Par exemple, si vous définissez l'alias de l'expéditeur sur « Alice » et l'adresse de l'expéditeur sur test@example.net, le destinataire verra « Alice » <test@example.net>. |
HtmlBody | String | Non | body | Le corps HTML de l'e-mail. La taille est limitée à 80 Ko par le kit de développement logiciel (SDK). Remarque : HtmlBody et TextBody spécifient le contenu de l'e-mail. Vous devez spécifier l'un ou l'autre. |
TagName | String | Non | test | Le tag que vous créez dans la console Direct Mail. Vous pouvez utiliser des tags pour classer les lots d'e-mails et interroger l'état d'envoi de chaque lot. Si vous activez le suivi des e-mails, vous devez utiliser un tag d'e-mail. |
TextBody | String | Non | body | Le corps texte de l'e-mail. La taille est limitée à 80 Ko par le SDK. Remarque : HtmlBody et TextBody spécifient le contenu de l'e-mail. Vous devez spécifier l'un ou l'autre. |
ReplyAddress | String | Non | test2***@example.net | L'adresse de réponse. |
ReplyAddressAlias | String | Non | Xiaohong | L'alias de l'adresse de réponse. |
UnSubscribeLinkType | String | Non | default | Le type de lien de désabonnement à générer. Pour plus d'informations, consultez Fonctionnalité de désabonnement.
« google », « aol.com », « hotmail », « outlook », « ymail.com », etc.
|
UnSubscribeFilterLevel | String | Non | mailfrom_domain | Le niveau de filtrage. Pour plus d'informations, consultez Fonctionnalité de désabonnement.
|
Paramètres de réponse
|
Nom |
Type |
Exemple |
Description |
|
EnvId |
String |
xxxxxx |
L'ID de l'événement. |
|
RequestId |
String |
2D086F6-8F31-4658-84C1-006DED011A85 |
L'ID de la requête. |
Exemples
Exemple de requête
https://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test***@example.net&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1***@example.net&<Common request parameters>
Exemples de réponse
Format XML
<SingleSendMailResponse> <EnvId>xxxxxx</EnvId> <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>
Format JSON
{ "EnvId":"xxxxxx", "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"}
Codes d'erreur
|
Code d'état HTTP |
Code d'erreur |
Message d'erreur |
Description |
|
400 |
InvalidReceiverName.Malformed |
The specified receiver name is wrongly formed. |
Le format de l'adresse du destinataire n'est pas valide. L'adresse doit contenir un signe at (@). Le nom du compte et le nom de domaine ne peuvent contenir que des lettres, des chiffres, des traits de soulignement (_), des traits d'union (-) et des points (.). |
|
404 |
InvalidMailAddress.NotFound |
The specified mail address is not found. |
L'adresse de l'expéditeur est introuvable. |
|
404 |
InvalidReceiver.NotFound |
The specified receiver is invalid. |
Le destinataire n'existe pas. Vérifiez si l'adresse du destinataire est valide. |
|
400 |
InvalidToAddress |
The specified toAddress is wrongly formed. |
Le format de l'adresse du destinataire n'est pas valide. L'adresse doit contenir un signe at (@). Le nom du compte et le nom de domaine ne peuvent contenir que des lettres, des chiffres, des traits de soulignement (_), des traits d'union (-) et des points (.). |
|
400 |
InvalidToAddress.Spam |
Sendmail rejected by invalid address. |
L'adresse n'est pas valide. Vérifiez la validité de l'adresse. |
|
400 |
InvalidBody |
The specified textBody or htmlBody is wrongly formed. |
Le format de TextBody ou HtmlBody n'est pas valide. Spécifiez à nouveau le contenu. |
|
400 |
InvalidSendMail.Spam |
Sendmail rejected by spam filter. |
L'envoi de l'e-mail a échoué. Vérifiez l'état de l'utilisateur pour détecter des problèmes tels qu'une limite de fréquence dépassée ou un quota insuffisant. |
|
400 |
InvalidMailAddressSendType.Malformed |
The specified mailAddress sendType is wrongly formed. |
Le type d'envoi n'est pas valide. Accédez à la console pour vérifier le type et définir la valeur en conséquence. |
|
400 |
InvalidMailAddressStatus.Malformed |
The specified mailAddress status is wrongly formed. |
L'état de l'adresse de l'expéditeur n'est pas valide. Vérifiez si l'adresse est active ou gelée. |
|
400 |
InvalidMailAddressDomain.Malformed |
The specified mailAddress domain does not exist. |
Le format du nom de domaine n'est pas valide. Il ne peut contenir que des lettres, des chiffres, des traits de soulignement (_), des traits d'union (-) et des points (.). |
|
400 |
InvalidSubject.Malformed |
The specified subject is invalid. It must not exceed 100 characters. |
L'objet n'est pas valide. Il ne peut pas dépasser 100 caractères. |
|
400 |
InvalidFromAlias.Malformed |
The specified fromAlias is wrongly formed. |
Le format de l'alias de l'expéditeur n'est pas valide. Il ne peut pas dépasser 15 caractères. |
|
400 |
InvalidReplyAddressAlias.Malformed |
The specified replyAddressAlias is wrongly formed. |
Le format de l'alias de l'adresse de réponse n'est pas valide. Il ne peut pas dépasser 15 caractères. |
|
400 |
InvalidReplyAddress.Malformed |
The specified replyAddress is wrongly formed. |
Le format de l'adresse de réponse n'est pas valide. L'adresse doit contenir un signe at (@). Le nom du compte et le nom de domaine ne peuvent contenir que des lettres, des chiffres, des traits de soulignement (_), des traits d'union (-) et des points (.). |
|
404 |
InvalidIP.NotFound |
The specified IP address is invalid. |
L'adresse IP spécifiée n'est pas valide. Si vous avez activé la protection IP, assurez-vous que l'adresse IP figure dans la liste. |
|
400 |
InvalidFromALias.Malformed |
The specified fromAlias is wrongly formed. |
L'alias de l'expéditeur n'est pas valide. Vérifiez l'alias de l'expéditeur. Il doit comporter moins de 15 caractères. |
Pour plus d'informations sur les codes d'erreur, consultez le Centre d'erreurs.