跳到主要内容

发送邮件

直接发送邮件,无需使用模板。支持批量发送给多个收件人,所有收件人将收到相同内容的邮件。

请求信息

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

注意事项

  • From 字段可在域名设置中获取
  • To 数组长度为 1-100 个邮箱地址
  • Subject 长度限制 1-200 字符
  • HtmlText 至少需要一个包含内容;Content 为空时 Html 优先于 Text 生效
  • CcBcc 收件人最终会与 To 合并去重后一起投递;Cc + Bcc 合计最多 100 个
  • Attachments:最多 10 个附件,总大小不超过 10MB;上传附件时须改用 multipart/form-data 方式提交,附件直接以表单文件字段上传,无需手动 Base64 编码
  • Headers{Name, Value} 对象数组,最多 20 个;Name 仅允许字母、数字和 -,不可使用保留名称(FromToSubjectReply-ToContent-TypeMime-VersionX-SES-* 前缀);Value 不可包含换行符
Fromstring必填
发件人邮箱地址
?
Tostring[]必填
收件人邮箱地址数组(1-100 个)
?
Subjectstring必填
邮件主题,长度 1-200 字符
?
Htmlstring
HTML 格式邮件内容
?
Textstring
纯文本格式邮件内容
?
FromNamestring
发件人昵称
?
PreHeaderstring
邮件预览摘要文字(收件箱列表中显示在主题旁的摘要文字)
?
Ccstring[]
抄送人邮箱地址列表,与 Bcc 合计最多 100 个
?
Bccstring[]
密送人邮箱地址列表,与 Cc 合计最多 100 个
?
Attachmentsfile
邮件附件列表(JSON),最多 10 个,合计不超过 10MB;上传附件时须改用 multipart/form-data
?
Headersstring
自定义邮件头(JSON 数组,每项为 {Name, Value} 对象),最多 20 个
?

响应格式

字段名类型说明
RetCodeint返回码,0 表示成功
Messagestring返回消息
SessionNostring会话编号,用于查询发送状态

常见错误码

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

更新说明 (2026-07-28)

SendEmail / TargetEmailAddress / Content 已废除,请分别使用 From / To / Html(或 Text)代替。老字段仍可使用,但新老字段同时传入时以新字段为准。

语言

凭证

👁️
🔒
🔑登录获取 ACCESSKEY_ID 和 ACCESSKEY_SECRET

请求地址

POST
CURL 请求
curl -X POST "https://api.uspeedo.com/api/v1/email/SendEmail" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Basic $(echo -n 'ACCESSKEY_ID:ACCESSKEY_SECRET' | base64)" \
-d '{
"From": "sender@example.com",
"To": [
"recipient1@example.com",
"recipient2@example.com"
],
"Subject": "欢迎使用 uSpeedo 邮件服务",
"Html": "<html><body><h1>欢迎</h1><p>这是一封测试邮件。</p></body></html>",
"FromName": "uSpeedo",
"PreHeader": "欢迎使用 uSpeedo 邮件服务"
}'

响应

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