发送邮件
在使用此API之前,请在控制台中准备以下内容:
- 设置自定义域名并验证通过。
- 设置发件人信息。
请求参数
字段名 | 参数类型 | 描述 | 必需 |
---|---|---|---|
Action | string | 值:SendEmail | 是 |
AccountId | int | 项目ID。获取AccountId | 是 |
SenderEmail | string | 在控制台的发件人设置中配置的电子邮件地址 | 是 |
EmailCoTargetEmailAddressntent | []string | 电子邮件接收地址,长度在1到100之间。 | 是 |
Subject | string | 邮件主题 | 是 |
Content | string | 邮件内容 | 是 |
响应参数
字段名 | 参数类型 | 描述 | 必须 |
---|---|---|---|
RetCode | int | 当 RetCode 不为 0 时,在 Message 中显示具体的错误描述。如果 RetCode 为 0,则不返回 Message。 | 是 |
Message | string | 返回状态码描述。如果操作成功,默认返回为空。 | 是 |
SessionNo | string | 此发送任务的唯一 ID。您可以根据该值查询发送的电子邮件列表。注意:仅当成功提交的电子邮件数量大于 0 时才返回该字段。 | 否 |
SuccessCount | int | 成功提交的电子邮件数量。 | 否 |
FailContent | []FailedTargetEmail | 未成功发送的详细信息,可根据该字段重新发送。 | 否 |
FailedTargetEmail 结构体
字段名 | 参数类型 | 描述 |
---|---|---|
EmailAddress | string | 电子邮件接收地址 |
FailureReason | string | 提交失败的原因。注意:如果模板/域名/发件人检查失败,则该字段为空。 |
请求示例
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
}