跳到主要内容

使用邮件模板发送邮件

使用已创建的邮件模板发送邮件，支持批量发送给多个收件人，每个收件人可使用不同的模板变量参数。

请求信息​

  • 获取公私钥：ACCESSKEY_ID:ACCESSKEY_SECRET
  • 请求方法：POST
  • 请求路径：/api/v1/email/SendEmailTemplate
  • Content-Type：application/json（上传附件时改用 multipart/form-data）

注意事项​

  • TemplateVariableParams 中变量格式为 变量名{##}变量值，多个变量以数组元素分隔
  • EmailContent 每项中的 Cc、Bcc：与 Cc 合计最多 100 个；CC/BCC 收件人共享该条目的变量渲染结果
  • Attachments：最多 10 个附件，总大小不超过 10MB；上传附件时须改用 multipart/form-data 方式提交，附件直接以表单文件字段上传，无需手动 Base64 编码
  • Headers：{Name, Value} 对象数组，最多 20 个；Name 仅允许字母、数字和 -，不可使用保留名称（From、To、Subject、Reply-To、Content-Type、Mime-Version、X-SES-* 前缀）；Value 不可包含换行符
Fromstring必填
发件人邮箱地址
?
TemplateIdstring必填
邮件模板 ID 控制台管理模板
?
EmailContentobject[]必填
邮件内容对象数组（每项含 To、Cc、Bcc、TemplateVariableParams）
EmailContent 预览
以下内容会被自动拼装到请求体中。
[
  {
    "To": "recipient@example.com",
    "Cc": [],
    "Bcc": [],
    "TemplateVariableParams": [
      "{1}{##}张三",
      "{2}{##}123456"
    ]
  }
]
收件人 1
FromNamestring
发件人昵称
?
PreHeaderstring
邮件预览摘要文字（收件箱列表中显示在主题旁的摘要文字）
?
Attachmentsfile
邮件附件列表（JSON），最多 10 个，合计不超过 10MB；上传附件时须改用 multipart/form-data
?
Headersstring
自定义邮件头（JSON 数组，每项为 {Name, Value} 对象），最多 20 个
?

响应格式​

字段名类型说明
RetCodeint返回码，0 表示成功
Messagestring返回消息
SessionNostring会话编号，用于查询发送状态
FailedTargetEmailsarray发送失败的收件人列表（每项：EmailAddress、TemplateVariableParams、FailureReason）

常见错误码​

错误码说明
0成功
215392参数错误
215397缺少必填参数
215400服务器错误

更新说明 (2026-07-28)​

SendEmail / EmailContent[].EmailAddress / Abstract / 顶层 Cc/Bcc 已废除，请分别使用 From / EmailContent[].To / PreHeader / EmailContent[].Cc/Bcc 代替。老字段仍可使用，但新老字段同时传入时以新字段为准。

语言

凭证

👁️
🔒
🔑登录获取 ACCESSKEY_ID 和 ACCESSKEY_SECRET

请求地址

POST
CURL 请求▼
curl -X POST "https://api.uspeedo.com/api/v1/email/SendEmailTemplate" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Basic $(echo -n 'ACCESSKEY_ID:ACCESSKEY_SECRET' | base64)" \
  -d '{
  "From": "sender@example.com",
  "TemplateId": "template_123",
  "EmailContent": [
    {
      "To": "recipient@example.com",
      "TemplateVariableParams": [
        "{1}{##}张三",
        "{2}{##}123456"
      ]
    }
  ],
  "FromName": "uSpeedo",
  "PreHeader": "新用户欢迎邮件"
}'

响应

点击“发起请求”后，可在此查看响应结果。