SMTP 邮件发送接口对接说明

一、基础接口信息

接口地址

http://smtp.mgznb.cn/smtp.php

请求方式

仅支持POST

GET 请求直接拒绝

请求头类型

application/x-www-form-urlencoded (表单提交格式)

跨域支持

允许所有域名调用（Access-Control-Allow-Origin: *）

响应格式

JSON (UTF-8编码，无BOM头)

超时时间

建议客户端设置 30 秒超时

二、必填参数列表（无可选参数）

参数名	类型	是否必填	参数说明及校验规则
`to`	string	是	收件人邮箱，格式必须合法（如：test@qq.com）校验规则: 使用 filter_var($to, FILTER_VALIDATE_EMAIL) 验证，非法格式直接返回错误
`subject`	string	是	邮件主题，支持中文处理规则: 接口自动对中文主题进行Base64编码，避免邮件客户端乱码
`content`	string	是	邮件内容，支持 HTML 格式校验规则: 会检测敏感词，命中则拒绝发送；HTML标签需闭合，避免解析异常

三、响应结果详解

1. 响应字段通用说明

字段名	类型	字段说明
`status`	bool	true = 发送成功；false = 发送失败（核心判断字段）
`msg`	string	成功/失败的详细描述，可直接展示给用户
`smtp-code`	int	成功时返回本次使用的邮箱配置编码；失败时返回0
`hit-words`	array	敏感词检测失败时返回，列出命中的敏感词列表

2. 成功响应示例

成功响应

{ "status": true, "msg": "邮件发送成功", "smtp-code": 1 }

3. 失败响应示例（含场景覆盖）

3.1 参数类错误

非法邮箱格式

{ "status": false, "msg": "非法邮箱格式：test@xxx", "smtp-code": 0 }

参数缺失

{ "status": false, "msg": "参数缺失 - 缺少主题或内容", "smtp-code": 0 }

3.2 内容检测类错误

敏感词命中

{ "status": false, "msg": "包含敏感词：赌博,诈骗赌博、色情、毒品、诈骗、刷单、博彩、六合彩、枪支、弹药、淫秽、裸聊、卖淫、嫖娼、约炮、迷奸、砍人、辱骂、脏话、人身攻击、代骂、人肉、开盒、邪教、封建迷信、假钞、传销、洗钱、催情、迷药、管制刀具、炸药、吸毒、贩毒、制毒、冰毒、海洛因、大麻、摇头丸、迷幻药、春药、强奸、轮奸、幼女、乱伦、偷拍、色情直播、招嫖、一夜情、露骨、低俗、脑残、废物、贱人、婊子、杂种、死全家、咒骂、恐吓、暴力、家暴、虐童、自残、自杀、跳楼、割腕、爆炸、恐怖袭击、暗网、黑客、盗号、钓鱼网站、非法集资、高利贷、套路贷、裸贷、跑分、洗黑钱、假证、假币、走私、偷渡、野味、电击枪、弓弩、气枪、炸药配方、炸弹", "smtp-code": 0, "hit-words": ["赌博", "诈骗"] }

3.3 限制类错误

单邮箱每日超限

{ "status": false, "msg": "单邮箱每日发送已达上限(10次)", "smtp-code": 0 }

单IP每日超限

{ "status": false, "msg": "单IP每日发送已达上限(20次)", "smtp-code": 0 }

3.4 防刷封禁类错误

IP+邮箱组合封禁

{ "status": false, "msg": "IP+邮箱组合封禁中，剩余58分钟", "smtp-code": 0 }

IP永久封禁

{ "status": false, "msg": "该IP已被永久封禁", "smtp-code": 0 }

3.5 SMTP服务类错误

授权码错误

{ "status": false, "msg": "授权码验证失败：535 Login Fail", "smtp-code": 0 }

SMTP服务连接失败

{ "status": false, "msg": "连接SMTP服务失败：Connection ref", "smtp-code": 0 }

四、核心业务规则

敏感词过滤

检测词库：赌博、色情、毒品、诈骗、刷单、博彩、六合彩、枪支、弹药，赌博、色情、毒品、诈骗、刷单、博彩、六合彩、枪支、弹药、淫秽、裸聊、卖淫、嫖娼、约炮、迷奸、砍人、辱骂、脏话、人身攻击、代骂、人肉、开盒、邪教、封建迷信、假钞、传销、洗钱、催情、迷药、管制刀具、炸药、吸毒、贩毒、制毒、冰毒、海洛因、大麻、摇头丸、迷幻药、春药、强奸、轮奸、幼女、乱伦、偷拍、色情直播、招嫖、一夜情、露骨、低俗、脑残、废物、贱人、婊子、杂种、死全家、咒骂、恐吓、暴力、家暴、虐童、自残、自杀、跳楼、割腕、爆炸、恐怖袭击、暗网、黑客、盗号、钓鱼网站、非法集资、高利贷、套路贷、裸贷、跑分、洗黑钱、假证、假币、走私、偷渡、野味、电击枪、弓弩、气枪、炸药配方、炸弹等。
命中敏感词直接拒绝发送，并返回命中词列表。

发送限制

单邮箱每日上限：10次
单IP每日上限：20次

防刷封禁

1秒内连续发送≥5次 → IP+邮箱封禁1小时
1小时内连续失败≥10次 → IP永久封禁

五、对接注意事项

接口内部已配置多邮箱轮询，无需客户端做多账号控制
客户端超时建议设置为30秒（如+0/5/0）
避免邮件内容中出现H5标签，建议使用纯HTML样式
请先在调试中接口上测试，没问题后再上生产环境
接口返回的 smtp-code 字段仅用于问题排查，客户端无需处理