QQ邮件代发API文档
⚠️ 使用须知: 本API可以代发QQ邮件,支持自定义发件人名称和HTML内容,请严格遵守使用规范,勿用于非法用途。请求频率限制为每分钟最多15次。
如果遇到接口问题,可以在下方评论区留言或者发送邮件至:3839913185@qq.com
📋 接口基本信息
🔧 请求参数
参数名 | 类型 | 是否必需 | 说明 | 示例 |
---|---|---|---|---|
recipient | String | ✅ 是 | 收件人邮箱地址 | recipient@qq.com |
sender_name | String | ✅ 是 | 发件人显示名称 | 系统管理员 |
subject | String | ✅ 是 | 邮件主题 | 重要通知 |
text_content | String | ✅ 是 | 邮件文本内容 | 这是一封测试邮件 |
html_content | String | ❌ 否 | 邮件HTML内容 | 这是一封测试邮件 |
🌐 请求示例
使用cURL发送请求
curl -X POST \
https://sgyyds.hebil.xyz/api/qqyx.php \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'recipient=recipient@qq.com&sender_name=发件人名称&subject=邮件标题&text_content=这是文本内容&html_content=这是HTML内容
这是一封测试邮件
'
使用JavaScript发送请求
const formData = new FormData();
formData.append('recipient', 'recipient@qq.com');
formData.append('sender_name', '发件人名称');
formData.append('subject', '邮件标题');
formData.append('text_content', '这是文本内容');
formData.append('html_content', '这是HTML内容
这是一封测试邮件
');
fetch('https://sgyyds.hebil.xyz/api/qqyx.php', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
📨 返回结果
✅ 成功响应
{
"success": true,
"message": "邮件发送成功",
"data": []
}
❌ 错误响应
1. 参数错误 (400 Bad Request)
{
"success": false,
"message": "收件人邮箱格式不正确",
"data": []
}
2. 请求频率限制 (429 Too Many Requests)
{
"success": false,
"message": "请求过于频繁,请稍后再试",
"data": []
}
3. 其他错误
{
"success": false,
"message": "邮件发送失败,请稍后重试",
"data": []
}
💡 使用建议
- 📝 内容规范:邮件内容应符合相关法律法规,避免发送垃圾邮件
- ⏱️ 频率控制:合理控制请求频率,避免触发限制
- 📧 双版本内容:建议同时提供text_content和html_content,确保兼容性
- 📊 日志记录:记录邮件发送日志,便于追踪和排查问题
- 🛡️ 安全防护:对用户输入进行过滤,防止XSS攻击
🚨 常见问题
❓ 邮件发送后收不到怎么办?
请检查是否被收件人的垃圾邮件过滤器拦截,或联系技术支持查询发送状态。
❓ 支持发送附件吗?
当前版本不支持发送附件,后续可能会添加此功能。
❓ 可以自定义发件人邮箱吗?
目前发件人邮箱由系统统一分配,仅支持自定义发件人名称。
body {
font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
line-height: 1.6;
color: #333;
max-width: 900px;
margin: 0 auto;
padding: 20px;
background-color: #f8f9fa;
}
h1, h2, h3, h4 {
color: #2c3e50;
margin-top: 1.5em;
margin-bottom: 0.5em;
}
h2 {
border-left: 4px solid #3498db;
padding-left: 15px;
margin-top: 2em;
}
h3 {
color: #34495e;
margin-top: 1.5em;
}
h4 {
color: #16a085;
margin: 1em 0 0.5em;
}
.post-meta {
color: #666;
font-style: italic;
margin-bottom: 30px;
}
.warning {
background-color: #fff3e0;
border-left: 4px solid #ff9800;
padding: 15px;
margin: 20px 0;
border-radius: 4px;
}
.support {
background-color: #e7f4ff;
border-left: 4px solid #3498db;
padding: 15px;
margin: 20px 0;
border-radius: 4px;
}
.api-info {
background-color: #f8f9fa;
padding: 15px;
border-radius: 5px;
margin: 20px 0;
}
.info-item {
display: flex;
margin-bottom: 10px;
align-items: center;
}
.info-item:last-child {
margin-bottom: 0;
}
.label {
font-weight: bold;
min-width: 100px;
color: #2c3e50;
}
.value {
color: #3498db;
font-family: 'Courier New', monospace;
}
.params-table {
width: 100%;
border-collapse: collapse;
margin: 20px 0;
background: white;
border-radius: 5px;
overflow: hidden;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}
.params-table th, .params-table td {
border: 1px solid #ddd;
padding: 12px;
text-align: left;
}
.params-table th {
background-color: #f2f2f2;
font-weight: bold;
}
.code-block {
background-color: #2d2d2d;
color: #f8f8f2;
padding: 15px;
border-radius: 5px;
margin: 15px 0;
overflow-x: auto;
font-family: 'Fira Code', 'Courier New', monospace;
}
.response {
padding: 15px;
border-radius: 5px;
margin: 15px 0;
}
.response.success {
background-color: #e8f5e9;
border-left: 4px solid #4caf50;
}
.response.error {
background-color: #ffebee;
border-left: 4px solid #f44336;
}
.faq {
margin: 30px 0;
}
.faq-item {
background: white;
padding: 20px;
margin-bottom: 15px;
border-radius: 5px;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}
ul {
margin-left: 20px;
margin-bottom: 20px;
}
li {
margin-bottom: 8px;
}
a {
color: #3498db;
text-decoration: none;
}
a:hover {
text-decoration: underline;
}
@media (max-width: 768px) {
body {
padding: 15px;
}
h2 {
font-size: 1.3em;
}
.params-table {
font-size: 0.9em;
}
.params-table th, .params-table td {
padding: 8px;
}
.code-block {
padding: 10px;
font-size: 0.9em;
}
}
本文系作者 @sgyyds 原创发布在孙哥博客站点。未经许可,禁止转载。
暂无评论数据