调用SingleSendMail发送单条邮件。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
AccountName | String | 是 | test@example.com | 管理控制台中配置的发信地址。 |
AddressType | Integer | 是 | 1 | 地址类型。取值:
|
ReplyToAddress | String | 是 | true | 是否启用管理控制台中配置好回信地址(状态须验证通过),取值范围是字符串true或者false(不是bool值)。 |
Subject | String | 是 | Subject | 邮件主题,建议填写。 |
ToAddress | String | 是 | test1@example.com | 目标地址,多个 email 地址可以用逗号分隔,最多100个地址。 |
Action | String | 否 | SingleSendMail | 系统规定参数。取值:SingleSendMail。 |
ClickTrace | String | 否 | 0 |
|
FromAlias | String | 否 | 小明 | 发信人昵称,长度小于15个字符。 例如:发信人昵称设置为”小红”,发信地址为 |
HtmlBody | String | 否 | body | 邮件 html 正文,限制28K。 |
TagName | String | 否 | test | 标签 |
TextBody | String | 否 | 12121 | 邮件 text 正文,限制28K。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
EnvId | String | xxxxxx | 事件ID |
RequestId | String | 2D086F6-8F31-4658-84C1-006DED011A85 | 请求ID |
示例
请求示例
http(s)://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test@example.com&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1@example.com&<公共请求参数>
正常返回示例
XML
格式
<SingleSendMailResponse> <EnvId>xxxxxx</EnvId> <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>
JSON
格式
{ “EnvId”:”xxxxxx”, “RequestId”:”12D086F6-8F31-4658-84C1-006DED011A85”}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidReceiverName.Malformed | The specified receiver name is wrongly formed. | 收件人格式不正确,必须有@符号,域名组成为数字,字母,下划线,减号和点,账号组成为数字,字母,下划线,减号和点 |
400 | InvalidTemplateName.Malformed | The specified template name is wrongly formed. | 模板名格式不正确,模板名不能大于30个字符 |
404 | InvalidMailAddress.NotFound | The specified mailAddress does not exist. | 不存在,请检查批定的发信地址。 |
404 | InvalidTemplate.NotFound | The specified template does not exist. | 指定的模板不存在。 |
404 | InvalidReceiver.NotFound | The specified receiver does not exist. | 收件人不存在,请检查收件人是否存在 |
400 | InvalidToAddress | The specified toAddress is wrongly formed. | 收件人格式不正确,必须有@符号,域名组成为数字,字母,下划线,减号和点,账号组成为数字,字母,下划线,减号和点 |
400 | InvalidToAddress.Spam | Sendmail rejected by invalid address. | 无效地址,请检查地址有效性 |
400 | InvalidBody | The specified textBody or htmlBody is wrongly formed. | textBody或textBody格式错误,请重新填写内容。 |
400 | InvalidSendMail.Spam | Sendmail rejected by spam filter. | 发信被拒绝,请检查用户状态,是否是频率超限,额度等问题 |
400 | InvalidMailAddressSendType.Malformed | The specified mailAddress sendType is wrongly formed. | 发送类型不正确,请去控制台检查类型,设置相应的值 |
400 | InvalidMailAddressStatus.Malformed | The specified mailAddress status is wrongly formed. | 发信地址状态不对,请检查是否可用,是否是被冻结状态 |
400 | InvalidMailAddressDomain.Malformed | The specified mailAddress domain does not exist. | 域名格式不正确,请使用数字,字母,下划线,减号和点 |
400 | InvalidSubject.Malformed | The specified subject is wrongly formed. | 主题错误,主题不能超过100个字符 |
400 | InvalidFromAlias.Malformed | The specified fromAlias is wrongly formed. | 发信人别名格式错误,长度不超过15个符。 |
400 | InvalidReplyAddressAlias.Malformed | The specified replyAddressAlias is wrongly formed. | 回信地址别名格式不正确,长度不超过15个符 |
400 | InvalidReplyAddress.Malformed | The specified replyAddress is wrongly formed. | 回信地址格式不正确,必须有@符号,域名组成为数字,字母,下划线,减号和点,账号组成为数字,字母,下划线,减号和点 |
访问错误中心查看更多错误码。
</article>
</main>
在文档使用中是否遇到以下问题
更多建议
匿名提交