Tous les produits
Search
Centre de documentation

:SingleSendMail

Dernière mise à jour :Aug 09, 2026

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

Vous pouvez appeler cette opération directement dans OpenAPI Explorer. Cela vous évite d'avoir à calculer les signatures. Après un appel réussi, OpenAPI Explorer génère automatiquement des exemples de code du kit de développement logiciel (SDK).

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 :

  • 0 : compte aléatoire

  • 1 : adresse de l'expéditeur

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

  • 1 : active le suivi des données.

  • 0 (par défaut) : désactive le suivi des données.

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.

  • Désactivé : la génération est désactivée.

  • default : un lien de désabonnement est généré pour les e-mails provenant d'adresses d'expéditeur de type lot envoyés à des noms de domaine spécifiques, tels que ceux contenant les mots-clés « gmail », « yahoo »,

« google », « aol.com », « hotmail »,

« outlook », « ymail.com », etc.

  • zh-cn : généré pour l'instrumentation future du contenu.

  • en-us : généré pour l'instrumentation future du contenu.

UnSubscribeFilterLevel

String

Non

mailfrom_domain

Le niveau de filtrage. Pour plus d'informations, consultez Fonctionnalité de désabonnement.

  • disabled : aucun filtrage.

  • default : utilise la stratégie par défaut. Les e-mails par lot sont filtrés au niveau de l'adresse de l'expéditeur.

  • mailfrom : filtre au niveau de l'adresse de l'expéditeur.

  • mailfrom_domain : filtre au niveau du nom de domaine de l'expéditeur.

  • edm_id : filtre au niveau du compte.

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.