跳到主要内容

发送邮件

在使用此API之前,请在控制台中准备以下内容:

  • 设置自定义域名并验证通过。
  • 设置发件人信息。

请求参数

字段名参数类型描述必需
Actionstring值:SendEmail
AccountIdint项目ID。获取AccountId
SenderEmailstring在控制台的发件人设置中配置的电子邮件地址
EmailCoTargetEmailAddressntent[]string电子邮件接收地址,长度在1到100之间。
Subjectstring邮件主题
Contentstring邮件内容

响应参数

字段名参数类型描述必须
RetCodeint当 RetCode 不为 0 时,在 Message 中显示具体的错误描述。如果 RetCode 为 0,则不返回 Message。
Messagestring返回状态码描述。如果操作成功,默认返回为空。
SessionNostring此发送任务的唯一 ID。您可以根据该值查询发送的电子邮件列表。注意:仅当成功提交的电子邮件数量大于 0 时才返回该字段。
SuccessCountint成功提交的电子邮件数量。
FailContent[]FailedTargetEmail未成功发送的详细信息,可根据该字段重新发送。
FailedTargetEmail 结构体
字段名参数类型描述
EmailAddressstring电子邮件接收地址
FailureReasonstring提交失败的原因。注意:如果模板/域名/发件人检查失败,则该字段为空。

请求示例

curl 'https://api.uspeedo.com/api' \
--header 'X-AccessToken: eyJxxxxxxxxx1RI' \
--header 'Content-Type: application/json' \
--data-raw '{
"Action": "SendEmail",
"SendEmail": "send@example.com",
"TargetEmailAddress": ["recv@example.com"],
"Subject": "email subject",
"Content": "email content"
}'

返回示例

{
"Action": "SendEmailResponse",
"FailContent": [
{
"EmailAddress": "example@example.com",
"FailureReason": "reason"
}
],
"Message": "Success",
"RequestUuid": "bb7ee377-fa16-4df4-945a-0e624fc1316b",
"RetCode": 0,
"SessionNo": "6977469d-d6fc-47e1-ad46-67d866f80655",
"SuccessCount": 0
}