接口名称

邮件SMTP发信接口 API

接口介绍

在线进行邮件发信操作(需提交发信参数)

返回格式

JSON

请求方式

GET / POST

请求参数

具体请查看压缩包内 .md 文件

# SMTP发信API参数说明

## 必需参数

1. **host**  
   - 类型: string  
   - 说明: SMTP服务器地址  
   - 示例: `smtp.example.com`

2. **username**  
   - 类型: string  
   - 说明: SMTP认证用户名(通常是邮箱地址)  
   - 示例: `your@example.com`

3. **password**  
   - 类型: string  
   - 说明: SMTP认证密码  
   - 示例: `yourpassword`

4. **from_address**  
   - 类型: string  
   - 说明: 发件人邮箱地址  
   - 示例: `your@example.com`

5. **to**  
   - 类型: string 或 array  
   - 说明: 收件人邮箱地址(可多个)  
   - 示例: `recipient@example.com` 或 `["recipient1@example.com", "recipient2@example.com"]`

6. **subject**  
   - 类型: string  
   - 说明: 邮件主题  
   - 示例: `Test Email`

7. **body**  
   - 类型: string  
   - 说明: 邮件正文内容(支持HTML)  
   - 示例: `<h1>Hello World</h1><p>This is a test email.</p>`

## 可选参数

1. **from_name**  
   - 类型: string  
   - 默认值: 空字符串  
   - 说明: 发件人显示名称  
   - 示例: `Your Name`

2. **port**  
   - 类型: integer  
   - 默认值: 25  
   - 说明: SMTP服务器端口  
   - 常用值: 25(非加密), 465(SSL), 587(TLS)

3. **timeout**  
   - 类型: integer  
   - 默认值: 30  
   - 说明: 连接超时时间(秒)

4. **is_html**  
   - 类型: boolean  
   - 默认值: true  
   - 说明: 是否发送HTML格式邮件  
   - 示例: `true` 或 `false`

5. **cc**  
   - 类型: string 或 array  
   - 默认值: 空  
   - 说明: 抄送邮箱地址(可多个)  
   - 示例: `cc@example.com` 或 `["cc1@example.com", "cc2@example.com"]`

6. **bcc**  
   - 类型: string 或 array  
   - 默认值: 空  
   - 说明: 密送邮箱地址(可多个)  
   - 示例: `bcc@example.com` 或 `["bcc1@example.com", "bcc2@example.com"]`

7. **reply_to**  
   - 类型: string  
   - 默认值: 空  
   - 说明: 回复地址  
   - 示例: `reply@example.com`

## 注意事项

1. 当使用GET方式提交时，body参数中的HTML内容需要进行URL编码
2. 多个收件人/抄送/密送可以使用数组形式或逗号分隔的字符串
3. 密码等敏感信息建议使用POST方式提交
4. 端口号需要根据SMTP服务器的实际配置设置
5. 更多资源请前往 **益星博客** `blog.ayixing.cn` 查看

返回示例

{
  "success": true,
  "message": "邮件发送成功"
}

接口源码

解压密码

用户交流