跳到主要内容

发送邮件

接口说明​

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

请求信息​

请求参数​

参数名类型必填说明示例值
SendEmailstring是发件人邮箱地址"sender@example.com"
TargetEmailAddressarray是收件人邮箱地址列表，最少1个，最多100个["recipient1@example.com", "recipient2@example.com"]
Subjectstring是邮件主题，长度1-200字符"欢迎使用USpeedo邮件服务"
Contentstring是邮件内容，最少1个字符"邮件内容"
FromNamestring否发件人昵称"USpeedo"

注意事项​

  • TargetEmailAddress 数组长度限制为1-100个邮箱地址
  • Subject 长度限制为1-200个字符
  • Content 最少需要1个字符，支持HTML格式

请求示例​

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

响应格式​

成功响应​

{
  "RetCode": 0,
  "Message": "success",
  "SessionNo": "session_1234567890",
  "FailedTargetEmails": []
}

响应字段说明​

字段名类型说明
RetCodeint返回码，0表示成功
Messagestring返回消息
SessionNostring会话编号，用于查询发送状态
FailedTargetEmailsarray发送失败的收件人列表，每个元素包含：EmailAddress（邮箱地址）、FailureReason（失败原因）

失败响应​

{
  "RetCode": 215392,
  "Message": "Invalid parameter [SendEmail]"
}

常见错误码​

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